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Introduction 








Sinclair ZX Spectrum +3 
128K Integrated Home Computer/Disk System 


Following on from the outstanding success of the established ZX range of computers: the onginal 
Spectrum, the Spectrum +, the Spectrum 128 and the new generation Spectrum +2, we now proudly 
present the ZX Spectrum +3. a machine that combines the very best features of the previous Sinclair 
models, with the added convenience ofa fast access floppy disk drive. 


The whole isa truly complete computer/disk system which allies established Sinclair technology with 
AMSTRADS expertise in integration and engineering reliability. and flair for producing a ‘no 
nonsense all-in-one package. 


Software compatibility 





The +3 may be used with software wntten for the earlier models in the ZX Spectrum range. This 
means that a vast quantity of software already exists for ће +3. There are literally thousands of titles 
available covering every conceivable application. games, utilities, music, scientific, educational and 
many many more. 


The BASIC 


The +3 uses a computer language called BASIC (Beginners’ All-purpose Symbolic Instruction 
Code). BASIC 15 by far the commonest language for home computers. and +3 BASIC has been 
designed to be particularly easy to learn and use. 


How to read this book 


In order to get the best out of your +. itis vital that you read all the relevant information provided in 
this manual. If youskip various sections. it 1s likely that you will come to a grinding halt later оп! 








Therefore, you should adopt the follow 





reading programme. 


Chapter | - This chapter shows you how to connect up your +3 system Note especially the safety 
varnings regarding the wiring-up of the mains plug. 





Chapter 2 - This chapter describes the switching on ofthe +3 and shows you how to tune-in your TV 
to display the computer's signal. You are then shown how to select an option from the opening menu 
-and if you don't know how to do that, you'll not be able to use ће +3 atall!lf, however, you do know 
how to tune-in your TV and select menu options (perhaps by having previously used a Spectrum 128 
ora +2). then you may skip this chapter 












_—_——— 


Chapter 3 - This chapter shows you how to load commercially available disk software. If you never 
intend to use such software, then you may skip this chapter. 


Chapter 4 - This chapter shows you how to load commercially available pre-recorded tape software. 
Ifyou never intend to use such software, then you may skip this chapter. 


Chapter 8 - This chapter covers the use of the 43's built-in disk drive (known as drive А) You may 
skip this chapter only if you never intend use the disk drive during BASIC programming (perhaps 
having purchased ће +3 solely to load and run commercially available software (eg. games)), Note 
that if you have connected an additional disk drive (В) to ће +3, then throughout this manual you 
should take any general references to ‘the disk drive as meaning both drives (A: and B:). 


Chapter 6 - This chapter introduces you to +3 BASIC. In particular, it describes the editor and 
certain aspects of BASIC programming that differ from those of other computers. Therefore, even if 
you are an experienced BASIC programmer on another computer, you should still read chapter 6. 
Note that you'll require a blank CF-2 floppy disk as you work through this chapter. If, however, you 
never intend to program in BASIC and have purchased ће +3 solely to load and run commercially 
available software (eg. games), then you may skip this chapter. 


Chapter 7 - This is the one chapter that you may freely skip. It describes the 48 BASIC mode (in which 
the +3 operates exactly like the ‘old-style’ Spectrum - even in the editing and programming 
aspects). This mode is not recommended for anything other than a history lesson for the curious, or for 
loading old (Spectrum 48 only) tape software. You should certainly not use this mode for BASIC 
programming; indeed you cannot access many of the advanced features of the +3 (including disk 
drive, extra memory, RS232/MIDI/AUX interfaces or RAMdisk) from 48 BASIC. Notwithstanding the 
above, we have provided the relevant information im this chapter for your reference. 


Chapter 8 - This chapter forms the very heart of the manual. It is a complete guide to BASIC 
programming on ће +3. If you have programmed in BASIC before, then you may wish to use this 
chapter merely аз а reference guide, searching the main index to find the information you need from 
опе of the subsections. If, on the other hand, you are new to BASIC, you may wish to work through the 
chapter, one subsection at a time, developing your programming skills as you go. Once youare able 
to type in and run a program, and have grasped a few of the fundamentals of BASIC, then you may feel 
confident about skipping ahead to later subsections. If however, you never intend to program in 
BASIC and have purchased the +3 solely to load and run commercially available software (eg. 
games), then you may skip this chapter. 


Chapter 9 - This chapter shows you how touse the +3 asa calculator only. You may skip this chapter 
ifyou wish. 


Chapter 10- This chapter illustrates how add-ons (penpherals) are connected to the +3. Peripherals 
include such devices as a cassette unit, a printer, an additional disk drive, a joystick, etc. So if you're 
thinking of linking up any device at all to ће +3, check this chapter to make sure that you've got the 
right connections. If, on the other hand. you intend to use just the standard +3 set up (ie. computer 
and TV only), then you may skip this chapter. И 
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Precautions! 
You must read this.... 


(Don't worry if you are a little baffled by some of the technical jargon m this section: the importance of 
these warnings wall become clearer as you work through this manual.) 


l Always connect the mains lead of the power supply unit (PSU) to a 3-pin plug following the 
instructions given in chapter | 

2. Donotattempt to connect ће PSU to any mains supply other than 220-240V AC 50Hz. 

3 After youhave finished using the +3, alwaysdisconnect the PSU from the mains supply socket 


4. There are no user serviceable parts inside the equipment - DO NOT ATTEMPT TO GAIN 
ACCESS INSIDE THE PSU - THERE ARE HIGH VOLTAGES INSIDE. Refer all servicing to 
qualified service personnel 


5 Donotblockor cover the ventilation slotsin the equipment, 
6 Donotuse or store the equipment in excessively hot, cold. damp. or dusty areas 


7 Never plugin (or unplug) any device from any of the rear sockets while the +3 isswitched ол 
-doingso will probably damage both ће +3 and the device 


8. Never switch ће +3 on or off while a disk ıs inserted in the disk drive. Doing so may corrupt 
your disk, losing valuable programs or data. 


9 After you have switched off your TV (or VDU monitor), do not immediately disconnect the +3 
-waita few seconds or so 


10. Donotswitchoffthe +3 (orswitch on or off any penpheral devices connected to ће +3) while 
there is a program or data in the memory that you wish to keep - doing so тау make the +3 
‘crash’, losing the program or data 


ll. Always keep the disk drive and disks away from magnetic fields. For maximum data relabihty, 
do not position the disk drive close to your TV or monitor. or close to any source of electrical 
interference 


12, Ifyou have connected an additional disk drive to ће +3. keep the ribbon cable (to the additional 
drive) away from mains leads 


13. Whenever possible. make back-up (duplicate) copies of disks which contain valuable programs. 
Otherwise. should you accidentally lose or corrupt the disk replacirz it may prove very 
expensive 


14. Nevertouch the floppy disk surface itself. inside its protective casing 
15. Donoteject a disk while itis being read from or wntten tc. 


16 Always remember that formatting a disk will erase its previous contents. 


Chapter 1 
Open the box 





Subjects covered... 


Unpacking 
Fitting amains plug 
Setting up 
Unpacking 
Inside the carton, you'll find the following. 
The Spectrum +3 computer 
The power supply unit (PSU) 


‘The aerial lead 
This manual (together with your user registration/guarantee card) 







Spectrum +3 computer 


User registration/guarantee card 


pee 

E | 
veri ion 

This manual 








Fitting a mains plug 
The power supply unit for the Spectrum +3 operates from a 220-240 Volt AC 50Hz mains supply. 


Fita proper mains plug to the mains lead of the power supply unit. Ifa 13 Amp (BS1363) plug is used, a 
3 Amp fuse must be fitted. The 13 Amp fuse supplied in a new plug must NOT be used. If any other 
type of plug is used, a 8 Amp fuse must be fitted either in the plug or adaptor or at the distribution 
board. 


IMPORTANT - The wires in this mains lead are coloured in accordance with the following code... 


Blue Neutral 
Brown : Live 


As the colours of the wires in the mains lead of this apparatus may not correspond with the coloured 
markings identifying the terminals in your plug, proceed as follows.. 


The wire which is coloured BLUE must be connected to the terminal which is marked with the letter N 
or coloured black. 


‘The wire which is coloured BROWN must be connected to the terminal which is marked with the 
letter Lor coloured red. 


Disconnect the mains plug from the supply socket when not in use. 


Do not attempt to remove any screws, nor open the casing of the power supply unit. Always obey the 
warning on the rating label of the power supply unit... 


WARNING: LIVE PARTS INSIDE - DO NOT REMOVE ANY SCREWS 


Setting up 


We will now set up the standard +3 system. All you need (other than the items you unpacked) is a 
standard TV set (UHF). You can use a colour or black-and-white TV, but of course, with the latter you 
will not be able to enjoy the full colour capabilities of your +3. 


Note that if you wish to attach one or more add-ons, or peripherals, (eg. printer, joystick, cassette 
deck, second disk drive, monitor, audio amplifier, MIDI device, modem or other seria/expansion 
device) to your +3 system, youshould turn to chapter 10 (Peripheralsfor your +3). 


Place the +3 computer on a suitable flat surface, ready to be connected to your TV. Next, remove 
any plug which is already connected to the aerial socket at the back of the TV. Using the aerial lead 
provided with your +3, insert the larger plug into the TV's aerial socket, and insert the smaller plug 
into the socket marked TV at the back ofthe +3. 


Finally, insert the 6-pin DIN plug coming from the power supply unit into the socket marked PSU at 
the backofthe +3. 


The +3 system is now ready to be switched on. 
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TVset 






Spectrum +3 computer 


Thestandard +3 system set up 
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Chapter 2 
Operating your +3 





Subjects covered... 


Switching on 
Tuning-in your TV 
Usingthe +3 

The opening menu 


Switching on 





Connect the mains plug of the power supply unit to the 
socket-switch (ifn sary). The power indicator lamp on the top pan 


ins supply socket, and switch on the 
lofthe +3 should illuminate. 












Now switch on your TV. On the screen you will probably see either a faint TV picture or just random 
‘white noise’ and hear a loud ‘hissing’ sound the TV's speaker. Adjust the TV's volume contro] until 
the sound is ata comfortable listening level. The next thing to doissetupthe +3 ready for tuning-in 








Preparing to tune-in your TV 


The +3 is capable of genera its own test signal, enabling you to tune-in the TV accurately. The 
test signal consists of sixtee! ical colour bars (overprinted with tex! acters) which appear on 
the TV screen, and a repeating tone whichis reproduced through the TV's speaker. (If youare using a 
black-and-white TV, then the colour bars appear as varying shades of grey.) You will see and hear the 
test signal when you have completed the tuning-in of your TV (described ahead). 


ti 
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Switch on the test signal by holding down the BREAK key (at the top right of the keyboard) and while 
it is held down, press and release the RESET button (at the left hand side of the +3). Keep the 
BREAK key held down for a few seconds longer, then release it The test ‘signal will now be 
generated by the +3, and you should proceed to tune-in your TV as now described. 


Push-button TV channel selectors 


If your TV doesn't have push-button channel selectors, then skip to the section ahead entitled ‘Manual 
tuning’, 


If your TV does have push-button channel selectors, then press one of them to select a spare channel 
(ie. one not normally used for receiving TV or video programmes), Note that if your TV is equipped 
withan AFC (or АРТ) switch, then this should be set to the off position. 


Using the tuning control that corresponds to the selected channel, tune-in to the test signal (shown on 
the previous page). Make sure that both picture and sound are tuned-in for the best possible results, 


When you are satisfied with the tuning, then you may (if your TV is so equipped) set the AFC. (or AFT) 
switch to the on position. 


Finally, adjust the TV's brightness, contrast and colour controls for the clearest display of the text 
characters within the colour bars. 


Now that you have tuned-in one of the TV's push-button channel selectors specifically for the +3, you 
may thereafter select that particular channel whenever you wishtouse ће +3 with your TV, 


You may now skip to the section ahead entitled Using ће +3" 


Manual tuning 


Ifyour TV isn't equipped with push-button channel selectors, then you will have to use the TV's manual 
tuning knob to tune-into your +3. 


Having connected and switched on ће +3 and TV, switch on ће +3's test signal as described in 
the previous section entitled ‘Preparing to tune-in your TV, 


Tune-in the TV's manual tuning knob until the test signal is received. Make sure that both picture and 
sound are tuned-in for the best possible results. 


Finally, adjust the TV's brightness, contrast and colour controls for the clearest display of the text 
characters within the colour bars. 


Each time that you wish to set up and use the 4-3 with your TV, you should follow the above manual 
tuning procedure. 


You тау now skip to ће section ahead entitled Usingthe +3". 
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Having problems? 
Ifyou have tuned-in your TV satisfactorily, you may now skip to the section ahead entitled Usingthe +3". 


If, however, you are unable to tune-in your TV, the following check list may help you to ascertain where the 
problem lies, and what remedial action you can take. 


1, Problem... 
The power indicator lamp (on the top panel ofthe +3) isnot illuminated. 
Action... 


* Check6-pin DIN plug from power supply unit is plugged into PSU socket on computer. 
* Check mains plug of PSU is plugged into mains supply socket. 

* (Ifmains supply socket is switched) - Check supply socket switch ison. 

* Check connections and fuse in mains plug of PSU. 


2. Problem... 
The power indicator lamp is illuminated, but no signal whatsoever can be tuned-in on the TV. 
Action. 


* Check TV isset up and working correctly. 

* Check TV isstandard UHF type (colour or black-and-white). 

* Check aerial lead (supplied) is connected from computer to TV aenal socket. 

* (Ifyou have push-button channel selectors) - Check youare tuning-in the channel you selected. 


3. Problem... 
Only a poor signal from the computer can be tuned-in on the TV. 
Action. 


* Check TV issetupand working correctly. 

* Checkaenal lead (supplied) is fully plugged into computer and TV aenal socket. 
* (ETV isso equipped) - Check AFC (or AFT) switch is set to off position. 

* Check tuning-in has beencarried out as accurately as possible. 


4. Problem... 
A signal from the computer is being tuned-in, but it's not the test signal described above. 
Action... 


* Check computer's test signal has been switched on (as described in the previous section entitled 
‘Preparing to tune-in your TV). 


5. Problem. 
The test signal colour bars appear, but no sound (repeating tone) is audible from the TV's speaker. 
Action. 


* Check TV's volume controlis notat minimum. 
* Checktuning-in has been cared out asaccurately as possible. 
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6. Problem. 
The test signal sound (repeating tone) can be heard, but no colour bars can be seen on the TV. 
Action. 


* Check TV's brightness, contrast and colour controls are notat minimum. 
* Check tuning-in has been carried out as accurately as possible. 


7. Problem. 
The test signal colour bars and sound are tuned-in, butnone of the text characters can be read. 
Action. 


* Check tuning-in has been carried out as accurately as possible. 
* Check TV's brightness, contrast and colour controls are adjusted for best results. 


If you cannot identify the cause of your problem, try carrying out the entire procedure (from the 
beginning of this chapter) again. If the problem still persists, contact your Sinclair dealer. 


Using the +3 


The +3 system should now be fully set up, with the test signal colour bars on the screen, and the 
repeating tone coming from the TV's speaker. 


We will now switch off the test signal and start using the +3. Press and re 
the left hand side ofthe +3), The test signal will disappear from the scr 
opening menu 


ase the RESET button (at 
andin its place will be the 






The opening menu 








ves are available for use: drive A: is the built-in 
M: isthe +3'sintemal RAMdisk (more about this in 
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Note that the opening menu initially indicates wl 
disk drive (at the front of the computer) and 











chapter 8 part 20). If you have connected an external disk drive to the +3, then you will see drive B: 
also indicated on the menu. The opening menu will appear whenever you first plug in and switch on 
the +3, or whenever you press and release the RESET button. 


As its name suggests, the menu offers you a selection of options. You can choose from one of the four 
options which appear within the central box on the screen. These are. 


Loader - Choose this option if you wish to load Spectrum +3, Spectrum +2 or 
Spectrum 128 software. 

+3 BASIC ~ Choose this option ifyou wish to use ће +3 for BASIC programming. 

Calculator ~ Choose this option if you wishto usethe +3 asa calculator only. 

48BASIC - Choose this option if you wish to load Spectrum 48 software from tape (or 


wishtousethe +3 asa 48K Spectrum). 


How to choose an option 


Notice that the menu option Loader appears to be highlighted by a "bar. This means that the 
Loader option is ready to be selected - (the selection hasn't been confirmed yet). For the purpose 
of this example, let's assume that you don't want to select Loader, but that instead, you want to 
select +3 BASIC. This means that you need to move the highlight bar to the option +3 BAS I C. To 
do this, use the cursor keys (shown below) until the highlight bar moves to the desired position. 












































| ajs] | 





Cursor Keys 


When the highlight bar ison +3 BAS I C, confirm thischoice by pressing the ENTER кеу. 
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The computer then switches to ће +3 BASIC mode. You will see a black horizontal bar (containing 
the words +3 BASIC) towards the bottom of the screen, and a flashing blue and white blob (called 
the cursor) at the top left-hand comer. 


Don't worry if you know nothing about BASIC - we're not going to do any programming just yet - we'll 
simply return to the opening menu again. To do this, we use a different menu - this one's called the edit 
menu. Call up the edit menu by pressing the EDIT key. 





Again, using the cursor keys and ENTER, select the option E x i t to return to the opening menu. 


You may now select whichever opening mi 
refer to the following chapters for further infor 







u require. Depending upon your selection, 
tio 


Loader -Referto chapters 3 and 4. 
*3BASIC - Referto chapters 6 and 8. 
Calculator - Referto chapter 9. 

48BASIC -Referto chapters 4 and 7. 


IMPORTANT - Whenever you have finished using the 3, always disconnect the power 
supply unit from the mains supply socket (having first removed any disk from the disk drive). 
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Chapter 3 
How to load disk software 








Subjects covered... 


Disksforthe +3 
Loading disk software 
Abandoning loading 


This chapter describes the loading of commercially available disk software. 





(Fora description of the loading, savin matting, etc., procedures that you would use during BASIC 
programming, see chapter 6 and chapter 8 part 20.) 


Disks for the +3 


The +3 use t pact floppy disks. We str yr 
transfer. y nt F І 





nd that for reliable 
je by other leadh 






turer 





Each side of a disk may be used independently. A disk should be inserted with its label facing 
outward from the dnve, and with the side that you wish to use face up. 
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Loading disk software 


To load Spectrum +3, Spectrum +2 and Spectrum 128 software (a game, an utility program, etc.) 
from disk, carry out the following instructions. 


1. Setupandswitchonthe +3 so that the opening menu appearson the screen. 





2, Insert your software disk into the disk drive. 


3. Press the ENTER key to select the option Loader from the opening menu. (If you don't know 
about selecting menu options, refer back to chapter 2.) 


‘The software will start to load from disk. On the disk drive, you will see the read/write indicator lamp 
start to flash on and off (indicating that the disk is being read from). After a few seconds, the screen 
display will change and the software will be loaded, ready to use. 


When you have finished using the software and wish to use the +3 for something else, press and 
release the RESET button (at the left-hand side of the +3). Always remember that whenever the 
RESET button is pressed, everything in the computers memory (RAM) is cleared. You should 
therefore always make sure that you have completely finished with any program in ће +3 's 
memory, before you press the button. 


Ifyou are going to switch off the +3 completely, remember to remove any disk from the disk 
drive first. 








Abandoning loading 


Ifyou wish to abandon a loadin 
return to the opening menu. 


ess and release the RESET button The +3 will 
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Chapter 4 
How to load tape software 








Subjects covered... 


Using tape instead of disk 

Loading Spectrum +3,Spectrum +2 and Spectrum 128 software 
Loading Spectrum 48 software 

Abandoning loading 








f к. To use ti setup ће +3 system so that 
TAPE/SOUND socket at the back of the +3 (details of 


in chapter 1 





Spectrum +3, Spectrum +2 and Spectrum 128 software 
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2, Make sure that no disk is inserted m the disk drive. 


3. Press the ENTER кеу to select the option Loader from the opening menu (If you don't know 
about selecting menu options, refer back to chapter 2.) 


Now skip to the section ahead entitled ‘Loading from tape’ 


Note that when you select the Loader option from the opening menu, the +3 knows that you wish 
to load from tape (instead of disk) by automatically detecting the absence ofa disk in the disk drive. If 
a disk is inserted, the tape will be ignored. 


Spectrum 48 software 


To шаа Spectrum 48 software (а game, an utility program, etc.) from tape, carry ош the following 
instructions. 





1 Switch on the system so that the opening menu appearson the screen. 
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W to select a menu 


2. Select the optio 
essage will be 


option, refer b: 
displayedatthe 












When yousee t 


ig menu 
left-hand 








Loading from tape 


1 Insert the software tape into your cassette umt and make sure that it is rewound to the beginmng 


2 Play the cassette. As loading commences, the border colour will flash and appear striped, 
indicating that the program is being read’ from the tape. If your TV's volume control is turned up, you 
Willalso heara varying high-pitched tone. Again, thus san indication thal the program is being read, 


Most commercially available software cassettes take a few minutes to load. Initially, the program 
name may appear (toward the top left-hand corner of the screen) possibly followed by various other 
displays or messages (these will differ from procram fo program). 


When the program has loaded, stop the cassette. The software is then ready to use. 


When you have finished using the software and wish to use the +9 for something else, press and 
release the RESET button (at the left-hand side of the +3) Always remember that whenever the 
RESET button is pressed, everything in the computer's memory (RAM) is cleared. You should 
therefore always make sure that you have completely finished with any program in ће +3 5 
memory. before you press the button 


Abandoning loading 


If, while loading software from tape, you wish to abandon the loading operation, then simply press and 
release the RESET button. The +3 will return to the opening menu 


NOTE - Holding the BREAK key down while loading Spectrum +3°Spectrum +2 or Spectrum 128 
software will return the +3 to the opening menu: holding the кеу down while loading Spectrum 48 
software willreturn the +3 fothe48 BASIC mode 





Chapter5 
The +3 disk drive 





Subjects covered... 


Disks and drives 
Insertion 

Write protection 
Read/write indicator lamp 
Eject button 


Disks and drives 
The +3 use 


liwewer. muy 










If you have connected an additional disk dnve to ће +3, note that the main disk drive (within the 
+3) 1scalled drive A:and the second (additional) disk drive is called drive В: 


Insertion 


Each side of a disk may be used separately. A disk should be inserted with its label facing outward 
from the drive, and with the side that you wish to use face up. 








Write protection 


Inthe left-hand corner of each side of a blank disk you will see an arrow pointing to а small shuttered. 
hole. This 15 called the write protect hole. and allows you to protect the contents of the disk from 
erasure or overwriting. 





When the hole is closed, data can be written onto the disk by the computer. When the hole 15 open, 
however, the disk will not allow data to be wntten onto it, thus enabling you to avoid the accidental 
erasure of valuable programs 








To open the write protect hole. slide back the small shutter located at the left-hand corner of the disk, 
and the hole will be opened. 


Wnte protect hole (OPEN) 


--- 


Shutter 
OPEN 


Shutter 
CLOSED 








Write protection ON Write protection OFF 


Once the hole is open, write protection is ON. 
‘Toclose the write protect hole, simply shde the shutter to its closed position Write protectionis then OFF. 


Other manufacturers disks employ a small lever located in a slot at the left-hand corner. 


Lever 


Write protect 
hole 


(CLOSED) 


Write protechon OFF 





To open ће write protect hole on this type of disk. slide the lever towards the middle of the disk (using 
the tip ofa ball-point pen or similar object). 


Slide lever 
towards middle 
ofdisk 


Wnte protect hole (OPEN) 





Write protection ON 


Note that regardless of the method employed to open and close the wnte protect hole; opening the 
hole in all cases facilitates protection against overwriting. 


When your disk is in 


At the front of the disk dnve, you will see a push button (for ejecting the disk), and a red lamp (called 
the read/wnite indicator lamp) 






Read/wnite 


indicator lamp Eject button 
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Read/write indicator lamp 


This lamp indicates that data 1s being read from or wnitten to the disk. Note, however. that if a second 
disk drive is connected. the read/write indicator lamp on drive B. will be constantly on (except when 
drive A: isreading or writing to disk). 


Eject button 
Pressing in the eject button allows you to remove your disk from the disk drive. 
Do not press the eject button while the disk 1s being read from or written to. 


Always eject your disk from the disk drive before switching the system off. 





Chapter 6 
Introducing +3 BASIC 





Subjects covered... 


The editor 

The edit menu 
Renumbering a BASIC program 
Swapping screens 

Listing to the printer 

Typing ina program 
Movingthe cursor 

Running a program 
Commands and instructions 
Simple disk operations 
Formatting a disk 

Savinga program 
Filenames 

Disk catalog 

Loading a program 

Error reports 





п advanced editor to create, п j C programs. To enter the editor 
select the option +3 BASIC from the opening шеп, using the cursor keys and ENTER (If you don't 
know how to select a menu о refer back to chapter 2 





The screen should now look like this. 





Thereare three thingsto notice abot 
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———————— 


Firstly, there isa flashing blue and white blob in the top left-hand corner. Thisiscalled the cursor, and 
ifyou type any letters at the keyboard, then they will appear on the screen at the position of the cursor. 


Secondly, there's a black bar towards the bottom of the screen. This is called the footer bar, and tells 
you which part of the +3'= built-in software you're using. At the moment, itsays +3 BASIC because 
that's the name of the editor 


The last item of note at the moments the sma! screen. This fits between the footer bar and the bottom 
of the screen, and iscurrently blank It only has room for two lines of text, and is most often used by the 
+3 when it detects an error and needs to print a report to say so. It does have other uses, however, 
and these will be described later. 





Now press the EDIT key. You will notice two things happen - the cursor vanishes, and a new menu 
appears, Thisiscalled the edit menu. 


E] 


The edit menu's options are selected in the 
keysand ENTER), 





ne way as fot the opeming menu (by using the cursor 


Taking the options in turn. 


+3 BASIC - Thisoption simply cancels the edit menu and restores the cursor. On the face of it- not 
very useful; however, if EDIT is pressed accidentally, then this option allows you to return to your 
program with по damage done. 


mune the order of the instructions to be 
umber from | to 9999) at the 


Renumber - BASIC programs use line numbers to deten 
carned ош. You enter these numbers (which can be 
beginning of each program line you type in. Sele the Renumber option causes the BASIC 
programs line numbers to start at line 10 and go up ps of 10. BASIC commands which include 
references to line numbers (such as GO T0, GO SUB, LINE, RESTORE, RUN and LIST) also 
have these references renumbered accordingly. 
















If for any reason it's not possible to renumber, perhaps because there's no program in the +3, or 
because Renumber would generale line numbers greater than 9999, then the +3 makes a 
low-pitched bleep and the menu goes away. 


А useful aid to this renumbering facility can be found in chapter 8 part 33 


Screen - This ophon moves fhe cursor into the smaller (bottom) patt of the screen, and allows 
BASIC to be entered and edited there. This js most useful for working with graphics as any editing in 
the bottom screen does not disturb the top screen. To switch back to the top screen (which youcan do 
atany hme whilst editing), select the edit menu option Scr e en again. 


Print-Ifapnnterisconnected, this option will print-out a listing of the current program to it. When 
the listing has finished, the menu will go away and the cursor will come back. If for some reason the 
computer cannot print (eg. the printer ts no! connected or is off-line), then pressing the BREAK key 
twice will return you to the editor 


Exi t - This option returns you to the opening menu - the +9 retains any program that you were 
working on m ће memory. If you wish to go back to the programagain, select the option +3 BASIC 
from the opening menu. 


If you select the opening menu ороп 48 BASIC (or if you switch off or reset the +3), then any 
program in the memory will be lost (You may, however, use the opening menu ороп 
Calculator withoutlosinga program inthe memory.) 


Reset the computer and select +3 BASIC. Now type in the line below. As you type it in, the 
characters will appear on the screen (a character 15 a letter, number, space, etc. ). Note that to type in 
the equals sign = you should hold down the SYMB SHIFT key, then press the L key once, Try typing 
inthe line now. 


18 for f=1 to 100 step 10 


then press ENTER. Providing you have spelt everything correctly, the +3 should have reprinted 
the line with the words FOR, TO and STEP m capital letters, like this.. 


10 FOR f=1 TO 100 STEP 10 


The +3 should have also emitted a short high-pitched bleep, and moved the cursor to the start of the 
nextüne. 


If the hne remains m small letters and you hear a Jow-pitched bleep, then this indicates that you have 
typed in something wrong. Note also that the colour of the cursor changes to red when a mistake 15 
detected, ага you must correct the line before it will be accepted by the +9 To do this, use the 
cursor keys to move to the part of the line that you wish to correct then type папу characters you wish 
to insert (or use the DELETE key to remove any characters you wish to get rid of) When you have 
finally corrected the line, press ENTER. 





Now type in the line below... 
(The colon : is obtained by SYMB SHIFT and Z, and the minus sign - is obtained by SYMB SHIFT 
and J.) 


20 plot @,O0:draw f,175:plot 255,0:draw -f,175 


„then press ENTER, On the screen you will see... 


10 FOR f=1 TO 100 STEP 10 
20 PLOT 0,0: DRAW f,175: PLOT 
255,0: DRAW -f,175 


Don't worry about line 20 ‘spilling over’ onto the next line of the screen - the computer will take care of 
this and align the text so that it 1s easier to read. Unlike a typewriter, there's no need for you to do 
anything when you approach the end of a screen line because ће +3 detects this automatically and 
moves the cursor to the beginmng of a new line. 


The final line of this program to type in is. 


30 next f 


„again, press ENTER 


The numbers at the beginning of each line are called line numbers and are used to identify each пе. 
The line you just typed in is line 30, and the cursor should be positioned just below it. As an exercise, 
we will now edit line 10 (to change the number 100 to 255). Pressthe cursorup e key (four times) 
until the cursor has moved up to line 10. Now press ће cursor ngh! ў key until the cursor has moved 
to the right of 100. Press DELETE three times and you will see the 100 disappear. Now type in 
255 and press ENTER. Line 10 of the program has now been edited. 


10 FOR f=1 TO 255 STEP 10 


The computer has opened upa new line m preparation for some new text. Type. 


run 


Press ENTER and watch what happens. Firstly, the footer bar and the program lines are cleared off 
the screenasthe +3 BASIC editor prepares to hand over control to the program you've just typed in. 
Then the programstarts, drawsa pattern, and stops with the report. 


Ø OK, 30:1 
Don'tworry about what this report means 





————————————————D 
Press ENTER. The screen will clear and the footer bar will come back, as will the program listing. 
This takes about a second or so, during which time the +3 wont be taking input from the keyboard, 
зо don't try and type anything while it'sall happening. 

You've just done most of the major operations necessary to program and use а computer! First, you've 
given the +3 a list of instructions, Instructions tell the +3 what to do (like the instruction 
3@ NEXT f) Instructions have line number and are stored away rather than used immediately 
you type them in. Then yougave the +3 the command run to execute the stored program. 


Commands are just like instructions, only they dont have line numbers and the +3 carries them out 
immediately (as soon as ENTER is pressed). In general, any instruction can be used as a command, 
and vice versa - itall depends on the circumstances. Every mstruction or command must have at least 
one keyword. Keywords make up the vocabulary of the computer, and many of them requira 
parameters. In the command DRAW 40,200 for example, DRAW is the keyword, while 40 and 
200 are the parameters (telling the computer exactly where to do the drawing). Everything the 
computer does in BASIC will follow these rules. 


Now press EDIT and select the Screen option. The editor moves the program down into the. 
bottom screen, and gets nd of the footer bar. You can only see line 10 of the program as the rest is 
‘hiding’ off-screen (you can prove this by moving the cursor up and down). 


Press ENTER then type... 


run 


Press ENTER again, and the program will run exactly the same as before. But this time, if you press 
ENTER afterwards, the screen doesn't clear, and you can move up and down the program listing 
(using the cursor keys) without disturbing the top screen Ifyou press EDIT to get the edit menu, you 
mught think that this would mess up the top screen. However, the +3 remembers whatever's behind 
the edit menu and restores it when the menuis removed. 


To prove that the editor really is working in the bottom screen, press ENTER and change line 101a... 
10 FOR f=1 TO 255 STEP 7 


„by moving the cursor to the end of Ime 10 (just to the nghtof STEP 10), then pressing DELETE 
twice, and typing 7 (press ENTER). 


Now type... 
go to 10 
(Press ENTER.) The keywords go to tell the +3 not to clear the screen before starting the 


program. The modified program draws a slightly different pattern on top of the ald one. You may 
continue editing the program to add further patterns, if you wish. 


а 


A мота of warning - while editing in the bottom screen, don't try to edit instructions which аге тоте 
than two screen lines long. Otherwise, when the editor comes across an instruction which has its 
beginning от its end off-screen, it may become ‘confused’ (The same is true of the top screen, butof 
course, this is unlikely to cause any problems as the screen isso much larger.) 


One thing you may notice while you're typing away is that CAPS SHIFT and the number keys used 
together do strange things. CAPS SHIFT with 5, 6, 7 and 8 move the cursor about, CAPS SHIFT with 
{calls up the edit menu. CAPS SHIFT with Ø deletesa character, CAPS SHIFT with 2 is equivalent to 
CAPS LOCK, and finally CAPS SHIFT with 9 selects graphics mode. Ай of these functions are 
available using the dedicated keyson the +3, and so there is no reason why you should ever want to 
use the above CAPS SHIFT and number key alternatives 


Simple disk operations 


You have now seen how to place a program into the computer's memory by typing it in. This is all very 
well the first time you wnte a particular program, but what about if you switch off the computer and 
want to use the same program the next day? Surely you don't have to type it al) m again from scratch 
«the answer, of course, із no - the disk drive section of the +3 allows you to save a program from the 
computer's memory onto a disk, and to Joad a program from a disk into the computer's memory. This 
means that you can type іл à program, save it to disk, then happily switch off the +3 knowing that 
next time you switch it оп, you'll be able to load that same program back into ће memory. 


‘The final part of this chapter, therefore, deals with these two very important operations (saving and 
loading), However, before you can do either of these. you will be shown how to prepare a brand new 
disk so thatit is ready for saving programs onto. This preparation process is called formatting. 


You will need to have a brand new blank disk to hand as you work through this chapter Whatever 
you do -don'tuse a disk with any valuable software, games, etc. on it. 


Disks and tapes 


Even if you are familiar with tape saving and loading, it is worth pointing out two important points 
which must be remembered when dealing with disks: 


Firstly, a brand new blank disk cannot be simply taken out of its wrapper and recorded onto (as is the 
case with a tape) - instead, each side of a disk must be formatted first. Note that the formatting 
process completely erases that side of the disk. 


Secondly, it is important that disk files are correctly named" Filenames on tape тау vary greatly m 
length and may at times be omitted. Not so with disks - disk filenames must conform to very strict 
standards (and you will read about these shortly m the section ahead entitled Filenames) 


Formatting a disk 


Formatting can be likened to building a series of shelves and pigeonholes on a disk prior to ће 
storage of information on those shelves. In other words. formatting lays down an organised framework 
around which data can be put in or taken out. 
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The formatting process divides the disk into 360 distinctly separate areas. 
Track 39 


Outer Case 


Trackü 





There are 40 concentric tracks from the outside of the disk (Track 0) to the inside (Track 39), and each 
track is divided into 9 sectors 


Each portion of track in a sector can store up to 512 bytes of data; hence the total available space on 
each side of a disk is 180 kilobytes (180K). Note that 7K of the 180K is reserved for the computer's own 
use; this leaves 173K per side for your programs. 


We will now format a new blank disk, and save the program below. 
10 FOR f=1 TO 255 STEP 7 
20 PLOT 0,0: DRAW 1,175: PLOT 


255,0: DRAW -f,175 
30 NEXT f 


Which should still be in the memory from the previous exercise (check that the above program is 
currently in the memory by pressing ENTER then typing.. 


list 


(Press ENTER again.) [f the program isn'tin the memory (or you have since switched off ће +3), then 
switchiton. select +3 BAS I C and type in theabove program), 
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Insert side | of a new blank disk into the disk drive and type... 


format "a:" 


(Press ENTER.) The read/write indicator lamp on the disk drive will start to flash on and off. About 30 
seconds later, you will see the report. 


@ ok, 8:1 
You have now formatted side | of the disk. Once you have done this, you should not need to format side. 
1 ofthat disk ever again. 


(If you don't receive the above report (and some other message appears instead), check the section 
entitled ‘Error reports at the end of this chapter ) 


Saving a program 


Having formatted side 1, itis now ready for saving programsonto. 


In order that each program file on a disk can be identified, you must give the program a filename 
when you save it. For example, as the program that you are about to save draws a patterned picture, 
save the program using the name pattern pic’, ie. type in. 


save "pattern.pic" 


(Press ENTER.) Aftera few seconds. you will see the report. 
@ ok, 8:1 


The program is now saved onto disk 


(If you don't receive the above report (and some other message appears instead), check the section 
entitled ‘Error reports а! the end of this chapter.) 


Filenames 


Note thata filename on disk consists of two parts (fields). The first field is obligatory and can contain up 
to 8 characters (letters and numbers may be used but no spaces or punctuation marks), In the above 
example filename, ‘pattern’ is the first field. 


The second field is ophonal. You can use up to З characters (but again no spaces or punctuation), іп 
the above example filename, pic is the second field. 


Ifyou use two fieldsina filename, they must be separated by a dot (eg. ‘pattern pic’). 
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Disk catalog 
A catalog of the disk (tn alphabetical order) can be displayed by typing in. 


cat 


(Press ENTER.) The filenames of al! the programs on that side of the disk will be displayed, together 
with each files length (to the nearest higher kilobyte). The amount of free space will also be 
indicated 


PATTERN .PIC 1K 
172K free 


Loading a program 


Imagine that you have switched off the +3 and later want to load the program you have jus! saved. 
Do this now by resetting the +3 (using the RESET button) and selecting the ophon +3 BASIC 
from the opening menu. Type in. 


load "pattern.pic" 
(Press ENTER.) After a few seconds, you will see the report... 
@ OK, 0:1 


The program is now loaded from disk. Press ENTER and you will see the program listing displayed, 


(If you don't receive the above report (and some other message appears instead), check the next 
section enhitied ‘Error reports ) 


Once loaded, you may run the program by simply typing. 
run 


and pressing ENTER, as before. 


Error reports 
If you don't correctly carry out the instructions in this section, you may receive various error reports. If 


so, identify the report (from those shown below), read the explanation given, and then take the 
necessary corrective action. 


Drive not ready 


‘The above report means that you have probably forgotten to insert a disk into the disk drive. If there is 
adisk inserted in the disk drive, then eject it, re-insert it and try again. 
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Disk is write protected 


The above report means that you are trying to format, or save a program to, a disk which has its write 
protect hole open. Eject the disk, close its wnte protect hole, re-insert the disk and try again 


File not found 


The above report means that you are trying to load а program which doesn't exst on that side of the 
disk. Eject the disk, make sure that the correct disk is nserted (the nght way up) and try again. Take 
care to ensure that you accurately type m the filename to load. 


Bad filename 
ot. 


Invalid filename 


"The above reports mean that you are trying to load or save а program using an illegai filename (or no 
filename atall) Read the section entitled Filenames earher in this chapter, and try again 


Disk is already formatted 
A to abandon, other key continue 


"The above report means tha! you are trying to format а disk that has already been formatted. 1с 
general, a disk should need formatting only once (at the beginning of its е) In rare cases, а disk may 
become corrupted and there will be no alternative other than to format it agam. However, unless this 
isthe case, you should always type A (to abandon) when yousee the abave report 


NOTE- If you don't type A. then the formatting process will go ahead and completely erase that site oi 
the disk (as soon as you pressa key). 


It you find that one particular disk (or side ofa disk) keeps requiring formatting, then it is likely that the 
disk ilsélf is damaged and you should avoid using it in future. 


Some commands that fail will produce reports that offer you the options... 
- Retry, Ignore or Cancel? 


Ifyou receive the above options, then. 
. typing R (after taking the necessary corrective action) makes the computer retry the command; 


typing I makes the computer ignore the reason that the command failed in the first place anc 
continue regardlessly (typing I is therefore not recommended unless you know exactly what you're 
doing), 


typing С abandons the command (this may be followed by the appearance of anotherreport), 
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Further information 


Further information on disk operations (together with details of how to use the +3's RAMdisk and 
how to use an external cassette unit) can be found in chapter 8 part 20. A guide to +3DOS 
(the +3 Disk Operating System) will be found inchapter 8 part 27. 


4 


Chapter 7 
Using 48 BASIC 





Subjects covered... 


Using the +3 as a 48K Spectrum 
Entering 48 BASIC mode 

The keyboard under 48 BASIC 
Program entry 


The +3 has the ability to act exactly like a 48K Spectrum (or Spectrum +), This is achieved by 
selecting the option 48 BASIC from the opening menu. In 48 BASIC mode, many of the enhanced 
features of the +3 (such as the disk drive, extra memory, full screen editor, multi-channel sound, 
RS232/MIDI/AUX interfaces and RAMdisk) cannot be used. The JOYSTICK 1 and JOYSTICK 2 
sockets will still operate, however. 


The 48 BASIC mode is included for compatibility reasons only - there is no advantage in using 48 
BASIC mode (instead of +3 BASIC mode) to write programs, and it is not recommended. The 
following information is included for reference only, or for anybody who is used to the old 48K 
Spectrum and wants to use the machine immediately without having to learn about the +3 BASIC 
editor, 


‘There are, in fact, two methods of entering the 48 BASIC mode: the first is by selecting the 
48 BASIC option from the opening menu (if you don't know how to select a menu option, refer 
back to chapter 2). When 48 BASIC starts up, you will see the following on the screen. 





The second method allows you to enter the 48 BASIC mode while editinga +3 BASIC program. To 
do this(whilein +3 BASIC mode), type. 
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spectrum 


„апа press ENTER. The +3 will respond with an ОК message and wil! have changed to 48 BASIC 
mode, retaining any program that you had in memory. Once in 48 BASIC mode, there is no way back 
to +3 BASIC mode apart from resetting ће +3 (or switching off, thenon again), 


One major difference between 48 BASIC and +3 BASIC isin the entering and editing of programs 
(Note also that in 48 BASIC the tokens SPECTRUM and PLAY have replaced the user defined 
graphics characters for the keys Tand under +3 BASIC (values 163and 164).) 


Once in 48 BASIC mode, the keyboard performs as follows: 


All the BASIC commands, functions and operators are available directly from the keyboard rather 
than needing to be spelled out. In order to accommodate all these functions and commands, some 
keys have five or more distinct meanings, obtained partly by ‘shifting’ the keys (ie. pressing either 
CAPS SHIFT or SYMB SHIFT together with the required кеу); and partly by having the machine in 
different modes. The flashing cursor contains а letter (K, L, С, E or G) to indicate which mode you are 
operating in. 


K (for Keywords) mode automatically replaces L (for Letters) mode when the machine is expecting à 
command or program line (rather than input data), and from its positionon the line ће +3 knowsthal 
it should expect either a line number or a keyword. К mode occursat the beginning ofa line, or after à 
colon : (except їп a string), or after the keyword THEN. Whenever the К cursor appears, the next 
key pressed will be interpreted as either a keyword ога line number, as follows... 














ЯА. 
A TATAI 
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The keyboard in К mode 








L (for Letters) mode normally occurs at all times (other than K mode, described above), Whenever 
the L cursor appears, the next key pressed will be interpreted as per the legends on the key-tops 


al - а - a aa TT 
PLE 


[sd +t li: 


















































The keyboard in L mode 


In both К and L modes, pressing SYMB SHIFT together with a key will be interpreted as follows... 












































SYMB| ; 
ISHIFT| i 




















The keyboard using SYMB SHIFT in K or L mode 


Using CAPS SHIFT in L mode simply converts small letters to capitals. In K mode, however, CAPS 
SHIFT does not affect the keywords. 


С (for Capitals) mode isa variant of L mode whereby all letters appear as capitals, The CAPS LOCK 
key sused to change from L mode to С mode, and back again. 
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The keyboardin E mode 




























































































Applying GAPS SHIFT while in E mode, the next key pressed will be interpreted as follows.. 





HERE 
- EL tr TT 

TITRE СЕ m 
CAPS SHIFT | [= A „|, Jej- pel | CAPS SHIFT 
ЕТІ “ct 


The keyboard using CAPS SHIFT in E mode 
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Applying SYMB SHIFT while in Е mode, the next key pressed will be interpreted as follows... 


CLELLEEEELIE 
T] [е 

[>] É 529 n 

evel [| 111] „| | [ 


‘The keyboard using SYMB SHIFT in E mode 
























































"m | 



































EXTEND 
MODE 


























|j єм 














2 

































































G (for Graphics) mode occurs when GRAPH is pressed, and lasts until it is pressed again (or 9 is pres- 
sed on its own). A number key will give a mosaic graphic, and each of the letter keys (apart from V, W, 
X, Y and 2) will give a user-defined graphic which, until it is defined, will look identical to a capital 
letter. Whenever the 6 cursor appears, the next key pressed will be interpreted as follows... 
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| | |с] |BJNJM, 
[1111 ael. 
The keyboard in 6 mode 
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Applying CAPS SHIFT while in 6 mode inverts the mosaic graphics (ie. the ink colour becomes the 
paper colour, and the paper becomes the ink colour). Hence, the next key pressed will be 
interpreted as follows... 


| Eurre me |. 
aalw] [ETR PH I [Р, 


— LIABISIHISTHTS 
IUE ENITI 
la asi UE 


‘The keyboard using CAPS SHIFT in 6 mode 











































































































General keyboard notes 


Калу key is held down for more than 2 or 3 seconds, it will start repeating. Keyboard input appears in 
the bottom half of the screen as it 1s typed, each character (single symbol or compound token) being 
inserted just before the cursor. The cursor can be moved left and nght using the cursor control keys 
Bearer Ie екем The character to the left of the cursor can be removed «sing 
DI 


When ENTER is pressed, the line is either executed, entered into the program, or used as input data 
Ifthe line contains а syntax error, however, a flashing question mark ? appears next to the error. 


As program lines are entered, a listing is displayed in the top half of the screen The last line entered is 
called the current line and is indicated by the symbol > after ће line number. Any line in the program 
may be selected as the current line (for editing purposes) by using the up and down cursor keys e» 
(to the night of the space bar) To then edit the selected current line, press the EDIT key. (Editing 
takes place at the bottom of the screen.) 


When a command is executed or a program is run, output is displayed in the top half of the screen and 
remains there until either ENTER or the cursor up or down key oo is pressed. At the bottom of the 
screen appears a report giving а code (digit or letter) referred to їп part 29 of chapter 8 This repori 
тетаїп< оп the screen шїї а key is pressédand ће +3 returnsto К mode. 





Chapter 8 
The +3 BASIC programmer's guide 





Parti 
Introduction 


Whether you read chapter 6 first, or came straight here, you should beaware that... 


Commands are obeyed straight away. 
Instructions begin with a line number and are stored away for later use. 


This guide to BASIC starts by repeating some of the information given in chapter 6 (Introducing 
+3 BASIC), but in greater detail. You may also find exercises а! the end of some sections - don't 
ignore these, as many of them illustrate points that are hinted at in the text. Look through them, and do 
any that interest you or that seem to cover ground that you don't understand properly, 


The Keyboard 


ala [TJ] = 
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‘The characters used on the +3 compnse not only single symbols (letters, digits, etc.) but also compound 
tokens (keywords, function names, etc.). Everything must be typed in full, and in most cases it doesn't matter 
whether capital letters (known as UPPER CASE) or small letters (Jower case) are used. There are three sorts 
of keys on the keyboard. letter and number keys (called alphanumeric keys), symbol keys (punctuation 
marks), and control keys (things like CAPS SHIFT, DELETE andsoon). 
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The most commonly used keys for BASIC are the alphanumeric keys. When a letter key is pressed, a 
lower case letter will appear on the screen together with a flashing blue and white blob called the 
cursor. To get an upper case letter, the CAPS SHIFT key should be held down while the letter is 


If you wish to continuously type upper case letters, then pressing the CAPS LOCK key once will 
make all subsequent letters typed upper case. To retum to lower case letters, simply press 
CAPS LOCK again. 


To type the symbols which appear on the alphanumeric keys on the keyboard, ie. 
LEPESE WSs Е gre 


simply hold down the SYMB SHIFT key while the alphanumenc key with the required symbol on it 
ispressed (see the following diagram). 


11е] 

ришаш 
EE 
eal III] (I ] Ew 


Symbolsavailable using SYMB SHIFT 









































Additionally, the symbols. 


жш vt qu S 


„сап be obtained by first pressing the EXTEND MODE key once, then holding down SYMB SHIFT 
while pressing the appropriate alphanumeric key (see the following diagram). 
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eal [1]] | | 
Symbolsavailable using SYMB SHIFT in EXTEND MODE 

ейунде. losaic graphics (see the follo in 
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Mosaic graphicsavailable using GRAPH 




































































































































































Toobtain inverted mosaic graphics, press the above number keys while holding down CAPS SHIFT. 
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General keyboard notes 


Tany key is held down for mote than 2or 3 seconds, it will start repeating. As keysare pressed, a line 
will be built up on the screen. A line, by the way, means a line of BASIC, and may easily be several 
lines long on thescreen. The cursor keys (фо can be used to move about the lime, and if the part of 
the line that the cursor is moved to is off screen, then the text on screen will scroll up or down to display 
it Any characters typed will be inserted at the cursor, and pressing DELETE causes the character to 
the left of the cursor to be removed. As soon as ENTER is pressed or any attempl is made to move ће 
cursor offthe line, ће +3 checkstosee ifthe line makes sense Ifit does, then thereisa high-pitched 
bleep, and the line is either acted upon immediately or stored away as part of a program. If the line 
contains an error, then the +3 generates a low-pitched bleep and moves the cursor to the area 
‘where it thinks the error is (the colour of the cursor also changes to red to indicate the error). It is 
impossible to move off a line which contains an error -the +3 willalways move the cursor back, 


The monitor screen 
"This has 24 lines (each being 32 characters long) and is divided into two parts The larger (top) part of 
the screen is at most 22 lines and displays either a listing or program output Itas the one used most 
often for editing. When printing in the top part has reached its bottom limit, the contents scroll up by 
one line. If, however, scrolling would mean losing а line that you haven't yet had a chance to see, then 
the +9 stops with the message... 


scroll? 
Pressingany key (except М, BREAK or the space bar) will let scrolling continue, 


Pressing one of the keys N, BREAK ot the space bar will make the programstop with the report 


D BREAK - CONT repeats 


The smaller (bottom) part of the screen is used for editing short programs, entering input data. 
entering direct commands (where the main screen must not be used. eg. graphics programs), and 
also for displaying reports 


Program entry 

Ifthe program bemg entered gets bigger than the screen size, then the +3 attempts to display the 
area of most interest (usually the last line entered together with its surrounding hnes) You may, 
however, specify a different area of the program to be displayed using the command. 


LIST xx 
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„where Xxx isa line number, telling the +3 to bnnga specified area of the program into view. 


When а command is executed or a program is run, output is displayed in the top part of the screen and 
remains there when the program finishes (unti) a key is pressed). If the program is being edited in the 
bottom part of the screen, then any output in the top screen will stay there until itis either overwritten, 
scrolled off, or a CLS command is issued. The bottom screen may display a report giving a code 
(digit or letter) referred to in part 29 of this chapter. Thus report remains m the bottom screen unti] а 
key is pressed. 


While the +3 is runninga BASIC program, the BREAK key 1з checked every so often. This happens 
at the end of a statement, dunng use of the cassette unit (if connected) or printer (if connected), or 
while music is being played. Ifthe +3 finds that the BREAK key is pressed, then program execution 
stopsand displays a report. The program may then be edited. 








Part 2 
Simple programming concepts 


Subjects covered... 


Programs 
Line numbers 
Editing pi using Hoo 

RUN, LIST 

GO TO, CONTINUE, INPUT,NEW, REM 
PRINT 


Stopping a program 


Type in the following first two lines of a program (which will eventually print the sum of two numbers) 
Don't forget to press ENTER after you type each line. 


20 print a 
18 let a=10 


Note that the screen looks like this 
10 LET a=10 


20 PRINT a 


As we have already discussed - because these lines began with numbers, they were not obeyed 
immediately but were stored away as program lines. You will have also noticed here that the line 
numbers govern the order in which the program lines are to be executed, and as you can see on the 
screen, ће +3 sortsall the lines nto order whenever a new line is entered. 


Note also that although we typed each line in lower case letters, the keywords (ie. PRINT and LET) 
were converted to upper case as soon the line was entered and accepted by the +3. From now on, 
we will show keywords to be typed in upper case letters; however, you may continue to type in lower 
case letters 


(By the way, if you don't know what a keyword is, you should have studied chapter 6 before reading 
this chapter.) 


So far you have only entered one number, so type. 
15 LET b=15 


— 


„and press ENTER. Now youneed to change line 201o... 
20 PRINT a*b 


You could type out the replacement line in full, but it is far easier to move the cursor (using the cursor 
keys) to just after the a, and then type. 


*b (don't press ENTER yen 
Check that the line then reads... 


2@ PRINT atb 


»(thenpress ENTER. The cursor will move to the line below, and the screen should look like this. 
10 LET a=10 


15 LET b=15 
20 PRINT a*b 


What you have done in this program is to have assigned the value 10 to the variable called a, and the 
value 15 (о the variable called b. You have then instructed the computer to print the sum of these two 
values by simply adding the two variables 

Run this program by typing.. 


RUN 
and pressing ENTER. The sum of the two numbers will be displayed. 
25 
Run the program again and then afterwards, press ENTER and type. 
PRINT a,b 
Now press ENTER again and notice how the values of the variables а and b are still in ће +3 s 


memory, even though the program has finished. 
18 15 





Mistakes 
Ifyouentera hne by mistake, say... 
12 LET b=8 
„and you wish to delete the line, then simply type. 
12 


„апа press ENTER. Line 12 will vamsb, and the cursor will reappear where line 12 used to be. 
Now type 


30 


.and press ENTER. The +3 will search for line 30, and since there isn't one, it will fall off the end oi 
the program The cursor will be positioned just after the last line. If you enter апу non-existent line 
number (such as 30) then the +3 will place the cursor where it thinks the line would have been if it 
really existed. This can be a useful way of moving about large programs, but beware - il can also be 
very dangerous because if the line really did exist before you entered the line number -1t certainly 
wouldn't exist afterwards! 


‘To lista program on the screen, type. 
LIST 


„апа press ENTER. You may (particularly when working with more lengthy programs) wish to list 
from a certain point onwards. This can be achieved by typing an appropnate line number aller the 
LIST command. 


LIST 15 


and press ENTER, to see this illustrated 


When we were developing the above program, note how we were able to msert line 15 between the 
other two lines- this would have been impossible if they had been numbered | and 2 instead of 10 and 
20, Ittsalways good practice, therefore, to leave gaps between lime numbers. 


(Note that line numbers must be entered as whole numbers between | and 9909) 


If at some time, you find that you haven't left enough space between line numbers, then you may use 
the edit menu to renumber a program To do this, press the EDIT key then select the Renumber 
option from the menu that appears; this sets the gap between each line number to 10. Try this out and 
see how the line numbers change 
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Weare now going to use the BASIC command МЕМ This erases any existing programs and vanables 
inthe +3'smemory. The command should be used whenever youare about to start afresh, so type... 


and press ENTER. From now on. we wont mention press ENTER every time - we'll assume that 
you'll remember. 


‘With the opening menu on the screen, start up BASIC by selecting the option +3 BAS I C. 


Now carefully type in ths program. which converts Fahrenheit temperatures to Celsius 
(centigrade)... 


10 REM temperature conversion 
20 PRINT "deg F","deg C" 

30 PRINT 

40 INPUT "Enter deg F",f 

50 PRINT f, 

60 PRINT (f-32)*5/9 

70 60 TO 40 


Although you can type in al! of line 10 in lower case, only the REM will be converted to upper case on 
entry as is the only keyword that the +3 recognises Also, although the words 60 TO willappear 
witha space between them, they may be typed in as one word (6070) if you prefer. 


Now run the program. The instructions will start being carried out in the order determined by the line 
numbers. First of all, you'll see the headings deg F and deg C printed on the screen (as instructed 
by line 20), but what has line 10 done? It looks like the +3 has completely ignored it - їп fact, it has! 
The REM in line 10 stands for remark, so line 10 1 solely to remind you of what the program does, А 
REM command consists of REM followed by anything you like - the +3 will ignore everything after 
the REM, night up tothe end of the line. 


After line 20, the +3 carnes out line 30 which simply prints a blank line. When the +3 gets to the 
INPUT command in line 40 it waits for you to type in a value for the vanable f ~ you can tell this 
because at the bottom of the screen а flashing cursor. 


Type m a number (then press ENTER). The +3 displays the result and then waits for you to enter 
another number. This is because the instruchon inline 70says 60 TO 40 - mother words, instead 
ofrinning out of program and stopping, jump back to line 40 and continue running from there’, 


‘So, enter another temperature, then another. 


After а {ew more of these you might be wondering if the computer will ever get bored with this - it 
won't! Next time it asks for another number, hold down SYMB SHIFT and type A. The word STOP 
willappear, and when you press ENTER ће +3 comes back with the report. 


Н STOP in INPUT in Line 40:1 


which tells you why it stopped, and where (m line 40). (The : 1 after the line number in the report 
tells you that the Ist Instruction in Ime 401s being reported upon.) 


51 








Ifyou wish to continue the program, type. 
CONTINUE 


andthe +3 willask you for another number. 


When CONTINUE isused, the +3 remembers the line number in the last report that it sent you (as 
long ds the report was not Й OK) and jumps back to that line, which in this case із line 40 (the 
INPUT command). 


Stop the program again and replace line 70 by. 
70 60 TO 31 


There will be no perceptible difference to the running of the program because if the line number in à 
60 TO command refers to a non-existent line, then the jump is to the next line after the given 
number, The same goes for RUN (in fact. RUN onitsownactually means RUN 0) 


Keep entering numbers until the screen starts getting full. Whenit1s full, ће +3 will move the whole 
of the top half of the screen up one line to make room, losing the heading off the top - this 1s called 
scrolling. 


When youare tired of entering numbers. stop the program as before and enter the editor by pressing 
ENTER, 


Look at the PRINT statement in line 50. The , comma im this line ts very important 


Commas are used to make the printing start either at the left-hand margin, or in the middle of the 
screen (depending upon which comes next). Thus in line 50, the comma causes the Celsius 
temperature to be printed in the middle of the line 


A semicolon ; on the other hand. is used to make the next number (or characters) be printed 
immediately after the preceding one(s). 


Another punctuation mark you can use like this in PRINT commands is the * apostrophe. This 
makes whatever is printed next appear at the beginning of the next line on the screen. This also, 
happens by default at the end of each PR INT command 


Ifyou wish to inhibit this (so that whatever follows to be pnnted continues on the same line) you сап put 
à сотта or semicolon at the end of the PRINT statement. To see how this works, reolace line 50 in 
turn by each of these. 


50 PRINT f, 
50 PRINT f; 
50 PRINT f 


„and run the program each time to see the difference. 


The line with the comma (you typed m originally) prints everything in two columns; the line with the 
semicolon crams everything together, and the ime without ether, prints each number on a new line 
(youcould havealsoused PRINT f 'todothis). 
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Always remember the difference between commas and semicolons m PRINT commands, and do 
‘not confuse them with 2 colons which are used as separators between commands оп а single line, for 
example... 


PRINT f: 60 TO 40 


Now typein these extra lines. 


100 REM greeting program 

110 INPUT "Enter your name",n$ 
120 PRINT "Hello ";n$;"!" 

130 GO TO 110 


This isa separate program from the last one, but you may keep them bothinthe +3 atthe same time. 
Torun the newone, type. 


RUN 100 


Because this program expects yo 
number, 1t prints.out two string quot 





t à string (a character or group of characters) instead of à 
asareminder Sotypeina name and press ENTER. 








Next time round, you will get two string quotes again, but you don't have lo use them if you don't want 
to. Try this, for example. rub ош the quotes by pressing cursor nght ў then DELETE twice, and 
type. 


n$ 


Since there are no string quotes, ће +3 knows that it has to do some calculation - the calculation in 
this case is to find the value of the string variable called n$ (which is whatever name you happen to 
have typed in last time round). In this way, the INPUT statement acts like LET n$=n§, so the 
value of n$ is unchanged 


1f you wish to stop the program, delete the quotes then hold down SYMB SHIFT and type A, 
then ENTER. 


Now look back at that ВОМ 100 instruction which jumps to line 100 and runs the program from 
there. You may be asking, What's the difference between RUN 100 andGO TO 100% Well 
RUN 100 first of all clears all the variables and the screen, and after that works just Ше 
GO TO 100. Оп ће other hand, GO TO 100 doesn't clear anything, and there may well be 
occasions where you wish to run a program without cleaning any variables; here 60 TO would be 
necessary and RUN could be disastrous. so it is better not to get mto the habit of automatically typing 
RUN tostarta program. 


Another difference of course is that you may type RUN without a line number, and it starts off at the 
first linein the program; 60 TO mustalways be followed by a line number, 


-————————————— 
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Both this program and the temperature conversion’ program stopped because you pressed 
SYMB SHIFT and typed A in the mput line. Sometimes, you may write a program that уой can't stop 
and that won't stc p itself. Type.. 


200 GO TO 200 
RUN 200 


Although the screen is blank, the program is running - executing line 200 over and over agam This 
lcoksall set to go on forever unless you pull the plug out or reset the computer! However, there is à less 
drastic remedy - press the BREAK key. The program will stop with the report. 

L BREAK into program 


At the end of every statement, the program looks to see if this key 15 pressed, and if it is, then the 
program stops. The BREAK key can also be used when you are m the middle of üsing a pnnler, 3 
cassette unit, or varios other add-ons that you canattach tothe +3. 


In these cases there isa different report. 


D BREAK - CONT repeats 


The instruction CONT INUE in this case (and in most other cases too) repeats the statement where 
the progran) was stopped and carnes straight on with the next statement (after allowing for any jumps 
tobe made) 
Run the ‘name! program again and when t asks you for input, type. 
n$ (after removing the quotes) 
Because п $ isan undefined vanable. you will get the error report 
2 Variable not found 
If younow type. 
LET n$="Fremsley” 
(which producesthereport@ OK, 0: 1) andthentype 
CONTINUE 


you will find that you can use n$ as input data without any trouble: 


А 


In this case CONTINUE does a jump to ће INPUT command m line 110. It disregards ће report 
from the LET statement because that said OK and jumps to the command referred to in the previous 
report, 1е; line 110 This feature can be extremely useful as it allows you to їх а program that has 
stopped due to errors, and then CONT I NUE from that point. 


Аз we said before, the report L BREAK into program is special because after 1t, 
CONTINUE doesnotrepeat the command where the program stopped 


You have now seen the statements PRINT, LET, INPUT, RUN, LIST, GO TO, 
CONTINUE, NEW and REM, and they can all be used either as direct commands or in program. 
lines - this is true of almost all commands m +3 BASIC. however, RUN, LIST, CONTINUE and 
NEW аге not usually of much use ma program. 

Exercises. 

1 Puta LIS T statement ina program so that when you run it, it lists ttself afterwards 

2 Wntea program to input prices and print out the tax due (at 15 percent). Putin PRINT statements 
so that the +3 announces what it is going to do, and asks for the input price with extravagant 
politeness, Modify the program so that you can. also mput the tax rate (to allow for zero ratings or future 
changes), 

3 Writea program to pnnt a running total of numbers you input (like an adding machine), 


4, What would CONT INUE and NEW doina program? Can you think of any usesat all for this? 
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Part3 
Decisions 


Subjects covered... 


All the programs we have seen so far have been pretty predictable - they went straight through the 
instructions, and then went back to the begmning again. This 1s not very useful, as in practice, we 
would want the +3 to make decisions and act accordingly. The instruction to do this in BASIC takes 
the form. 


IF somethingis true (or not true) THEN do something 


Lets look at an example of this Use NEW to clear the previous program from the +3, select 
+3 BASIC, thentype mand run this program. (Thists clearly meant {or two people to р!ау!).. 


10 REM Guess the number 

20 INPUT "Enter a secret numbe 
"уаз. CLS 

30 INPUT "Guess the number",b 

4B IF bza THEN PRINT "That is 
correct": STOP 

50 IF b«a THEN PRINT "That is 
too small, try again" 

60 IF b»a THEN PRINT "That is 
too big, try again" 

70 GO TO 30 


Note that the CLS command (at the end of liie 20) means clear the screen’ We have used it in this 
program to stop the other person seeing the secret number after it is entered 
You can see that the І F statement takes the form. 


TF condition THEN xxx 


where ‘xxx’ stands for a command (or a sequence of commands separated by colons) The condition 
15 something that is going to be worked ош as either true or false - if it comes out as true then the 
statements m the rest of the line (after THEN) are executed; otherwise they are skipped over, and the 
program executes the next instruction. 





The simplest conditions compare two numbers or two strings; they can test whether two numbers are 
equal or whether one is bigger than the other. They can also test whether two strings are equal, or 
whether one comes before the other in alphanumerical order. They use the symbols =, <, >, <=, 
and <> (these are known as relational operators). 





means is equal to. 
meansisless than. 

Meansis greater than. 
meansis ess than or equal to. 
means 1s greater than or equal to. 
meansis not equal lo, 


AVAVAN 
nu 


Y 


(Ifyou keep getting mixed up about the meanings of < and >, it may help you to remember that the 
thin end of the symbol points to the number which is supposed to be smaller.) 


In the program we have just typed in, line 40 compares a and b. I{they are equal, then the program is 
halted by the S ТОР command. The reportat the bottom of the screen.. 


9 STOP statement, 40:3 


shows that the 3rd statement (е. the S TOP command) in line 40 caused the program to halt 


Line 80 determines whether b is less than a, and line 60 whether b is greater than a. Ifone of these 
conditions is true then the appropriate comment is printed, and the program works its way down to. 
line 70 which jumps back to line 30 and starts all over again. 


Finally, note thatin some versions of BASIC (not +3 BASIC) the I F statement can have the form. 


IF condition THEN line number 
This means the same as.. 
IF condition THEN GO ТО limenumber 
in +3 BASIC 
Exercise.. 
1. Try this program. 
10 LET a=1 
20 LET b=1 
3@ IF a>b THEN PRINT a;" is higher" 
4@ IF a<b THEN PRINT b;" is higher" 


Before you run it, try to work out what will be printed on the screen. 
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Part 4 
Looping 


Subjects covered... 


FOR, NEXT 
TO,STEP 


Suppose you wish to input five numbers and add them together 
One way (don't type this in unless you are feeling dutiful) is as follows. 


10 LET total-ü 

20 INPUT a 

30 LET total-total*a 
40 INPUT a 

50 LET total-total*a 
60 INPUT a 

70 LET total-total*a 
80 INPUT a 

90 LET total-total*a 
108 INPUT a 

110 LET total=totalta 
120 PRINT total 


‘This method is not good programming practice It may be just about controllable for five numbers, but 
you can imagine how tedious a program like this to add twenty numbers would be, and to add a 
hundred or more would be out of the question 


Much better is to set up а variable to count up to 8 and then stop the program, like this (which you 
should type tn). 


10 LET total=0 

20 LET count=1 

30 INPUT a 

4@ REM count is number of time 
s that a has been input so 
far 

50 LET total-total*a 

6@ LET count=count+1 

70 IF count <= 5 THEN 60 TO 30 

88 PRINT total 


Notice how easy it would be to change line 70 so that this program adds ten numbers, or even a hundred 
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EE 
‘This sort of thing 15 so useful that there are two special commands to make it easier - the FOR 
command and the NEXT command. They are always used together. Using these, the program you 
have just typed in does exactly the sameas 


10 LET total=0 

20 FOR c=1 TO 5 

30 INPUT а 

40 REM с is number of times th 
at a has been input so far 

50 LET total-total*a 

60 NEXT c 

80 PRINT total 


(To get this program from the previous one, you just have to edit lines 20, 40 and 60, then delete line 
70.) 


Note that we have changed count to c. This ıs because the control variable ofa FOR, NEXT loop 
must have a single letter asits name. 


The effect of this program is that c runs through the values | (the initial value), 2, 3, 4 and 5 (the limit), 
and each time, lines 30, 40 and 50 are executed. Then, when c has finished its five values, line 80 is 
executed. 


Atthis point, attempt exercise 2 (which refers to the above program), at the end of this section. 


An extra subtlety to the FOR... NEXT structure is that the control vanable does not have to go up by 1 
each time - you can change this | to anything you like by using a STEP part in the FOR command. 
The most general form ofa FOR commandis . 


FOR control vanable = imtial value TO limit STEP step. 


Where the control variable is a single letter, and where the mal value, the limit and the step аге all 
things that the +9 can calculate as numbers - like the actual numbers themselves, or sums, or the 
names ofnumentc variables. So, tf you replace line 201n the program by... 


2@ FOR c=1 TO 5 STEP 3/2 


this will step the control variable by the amount 3/2 each ume the FOR loop is executed. Note that 
we could have simply said STEP 1.5. ог we could have assigned the step value fo a variable, say 
S,andthensad STEP s. 


With the above modification, с will run through the values 1, 2.5 and 4. Notice that you don't have to 
restrict yourself to whole numbers, and also that the control value does not have to hit the limit exactly; 
itcarrieson loopingas long as itis less than or equal to the hnut 


Atthis point, attempt exercise 3at the end of this section (which refers to the above program). 
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Step values can be песапуе instead of positive. Try this program which prints out (he numbers from | 
to 10 inreyerse order (Remember. usethe command NEW before typing ina new program). 


10 FOR п=10 TO 1 STEP -1 
20 PRINT n 
30 NEXT n 


We said before that the program cares on looping as long as the control variable ts less than or equal 
to the limit. If you consider what that would mean in this case, yowll see that it now doesn't hold true 
Hence, the тше has to be modified to say that when the step 1$ negative, the program carnes on 
loopingas long as the contro} variable ts greater than or equal to the limit 


At this point, attempt exercises 4 and 5at the end of this sechon (which refer to the above program), 


You must be careful if you are running two FOR...NEXT loops together, one inside the other. Try this 
program, which pnntsout the numbers for à complete set of six dot dominoes 


18 FOR т=0 TO 6 


20 FOR п=0 TO m 
30 PRINT m;":";n;" "; n loop m loop 


40 NEXT n 
50 PRINT 
60 NEXT m 





Youcansee that the n loop ts entirely mside the m loop This means that they are properly nested. 


However, what must be avoided is haying two FOR... NEXT loops that overlap without either being 
entirely inside the other, like this. 


5 REM this program is wrong 
10 FOR m-0 TO 6 

20 FOR n=@ TO m 

30 PRINT m;":"; 
40 NEXT m n loop 
50 PRINT 

60 NEXT n 





Two FOR... NEXT loopsmust either be one inside the other, or completely separate. 


Another thing to avoid isjumping into the middle ofa FOR... NEXT loop from the outside. The contro! 
variable is only set up properly when its F OR statement is executed, and if you miss this out, then the 
NEXT statement will confuse the +3 You will probably се! an error report saying 
NEXT without FOR or Variable not found 
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Thereis nothing to stop youusmga FOR...NEXT loopina direct command Forexample. try... 


FOR т=0 TO 10: PRINT m: NEXT m 


You can sometimes use this as à (somewhat artificial) way of getting around the restriction that you 
cannot GO ТО anywhere inside а command - because а command has no line number. For 
instance.. 


FOR т=@ TO 1 STEP Ø: INPUT a: PRINT a: NEXT m 
Thestep size of zero here makes the command repeatitseli forever. 


This sort of thing 1s not really recommended, because if an error crops up then you have lost the 
command and will have to type it n адаш; moreover. CONT I NUE will not work. 


Exercises, 


1, Make sure that you understand that a contro! variable not only has а name and a value (like an 
ordinary variable), bur also a іти, a step, and a reference to the statement after the corresponding 
FOR statement. Ensure that when the FOR statement is executed all this information is available 
(using (he imha? value as the first value the Variable takes), and also that this information is enough for 
the NEXT statement 10 know by how much to increase the value, whether to jump back, and if so 
where to jump back to. 


2, Run the third programm thus section, then type.. 
PRINT c 


"Why is the answer 6, and not 5? 


(Answer: The NEXT command in line 601s exectited five times, each time | bemg added to c. On the. 
last time, c becomes 6 so the NEXT command decides not to loop back but to carry on, c now being 
past its limit) 


3 What happensifyouput STEP 2 atthe end ofline 20 ofthe third program? Try STEP 10 


Now change the third program so that instead of autotahcally adding five numbers, 1t asks you to 
input the amount of numbers you wish to add. When you run this program, what happensif you input Ø 
(meaning that you don't wish to add any numbers)? Why might you expect this to cause problems for 
the +3, even though itis clear what yournean? 


4 In lme 10 of the fourth program in this section, change 10 to 108 and run the program. it will print 
the numbers from 100 down to 79 on the screen, and then say s c r o L L? at the bottom. This is to give 
you a chance to see the numbers that are about to be scrolled off the top 1f you press N, BREAK or the 
Space bar, the program will stop with ће report 0 BREAK - CONT repeats. Ifyou press 
any other key, then it will pnnt another 22 lines and ask you again you wish to scroll 
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5. Delete line 30 from the fourth program. When you run the new curtailed program, it will print the 
firstnumberand stop with the message @ OK. Ifyou then type. 


NEXT n 


the program will go once round the loop, printing out the next number 








Part 5 
Subroutines 


Subjects covered... 


GO SUB,RETURN 


Sometimes, different parts of the program will have rather similar jobs to do, and you will find yourself 
typing in the same lines two or more times, however, this isnot necessary. Instead, you need only type 
in the lines once (in what's called a subroutine) and then call the subroutine into actiori whenever you 
need itin the program 


Todo this, youuse the statements 60 SUB (gotosubroutine)and RET URN. Thistakesthe form. 
GO SUB юх 


Where ххх is the line number of the first line їп the subroutine. Itis justlikeGO ТО xxx except that 
the +3 remembers where the GO SUB statement was. so that it can come back agam after 
carrying out the subroutine. 


(In case you are mterested. the +3 does this by remembering at which point in the program the 
60 SUB command was issued (in other words where 1t should continue from afterwards) and 
storing this return address on top ofa pile calledthe GO SUB stack) 


When the command. 


RETURN 


1s met (at the end of the subrounne itself), the #3 takes the top return address off Ihe G0 SUB 
stack, and continues from the next stalement 


Asan example, let's iook at the number guessing program again. Retype и ав follows 


10 REM "A rearranged guessing 
game" 

20 INPUT "Enter a secret numbe 
mas CLS 

30 INPUT "Guess the number",b 

40 IF b-a THEN PRINT "Correct" 
: STOP 

50 IF b<a THEN GO SUB 100 

60 IF b>a THEN GO SUB 100 

70 GO TO 30 

100 PRINT "Try again" 

118 RETURN 








The GO TO 30 statement in line 70 (and the STOP statement in иле 80 of the next program) are 
very important because otherwise the programs will run on into their subroutines and cause an error 
(7 RETURN without GO SUB)whenthe RETURNsistementisreached 


The following program uses а subroutine (from line 100 to 150) which prints a times table’ 
corresponding to the value of parameter n. The command 60 SUB 100 may be issued from any 
point in the program to call the subroutine When the RETURN command in lme 150 of the 
subroutine 15 reached, contro! retums {о the main program. which continues running from the 
statementafterthe GO SUBcall like GO TO GO SUBmaybetypedinas GOSUB. 


180 REM times tables for 2, 5, 
10 and 11 

20 LET n=2: GO SUB 100 

ЗӢ LET n-5: GO SUB 100 

40 LET n-10: GO SUB 100 

50 LET n=11: GO SUB 100 

60 STOP 

70 REM end of main program, st 
art of subroutine 

100 PRINT n;" times table" 

110 FOR t=1 TO 9 

120 PRINT t;" x ";n;" = ";t*n 

130 NEXT t 

140 PRINT 

150 RETURN 


One subroutine can happily cal! another, or even itself (a subroutine that calls seli 1s known as 
recursive) 
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Part6 
Data in programs 


Subjects covered.. 
READ, DATA, RESTORE 


In some of the previous programs we saw that information. or data, can be entered directly into 
the +3 using the INPUT statement. Sometimes this can be very tedious, especially if a lot of the 
data is repeated every time the program is Tun. You can save a lot of nme by using the READ, DATA 
and RESTORE commands. For example 


10 READ a,b,c 
20 PRINT a,b 
30 DATA 1,2, 


иб 
3 


А READ statement consists of READ followed by a list of the names of variables, separated by 
commas. It works rather like an INPUT statement, except that instead of getting you to type in the 
values to give to the vanables, the +3 looksup the values im the DATA statement, 


Each DATA statement isa list of expressions - numeric ot string expressions - separated by commas, 
You can put them anywhere you like in a program, because ће +3 ignores them except when it is 
doing a READ. You must imagine the expressions from ail the DATA statements in the program as 
being put together to form one long list of expressions - the DATA list The first time ће +3 questo 
READ a value, it reads the first expression from the DATA list. the next ume, it reads the second, and 
thus as it meets successive READ statements, it works its way through the DATA hst (If it mes to 
read past the end ofthe DATA list, thenit reportsan error.) 


Note that i's а waste of time putting DAT A statements ma direct command, because READ will not 
find them. DATA statements must go ina program. 


Lets see how all this works in the program you've just typed m. Lane 10 tells the +3 to read’three 
pieces of data and assign them to the variables a, b and c. Lane 20 then says PRINT these 
variables The DAT A statement in line 30 provides the values of a, b and c for line I0toread. 


‘The information in DATA can bepartofa FOR... NEXT loop Type in. 


10 DATA 2,4,6,8,10,12 
2B FOR n-1 TO 6 

30 READ d 

40 PRINT d 

50 NEXT n 


Note from the above two programs that a DAT A statement can appear anywhere - before or after the 
READ statement 
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When the above program is run, ће READ statement moves through the DATA list with each pass of 
the FOR... NEXT loop. 


DATA statements may also contain string variables. For example... 


10 FOR a=1 TO 7 

20 READ п$ 

ЗӢ PRINT n$ 

40 DATA "Bob","Edith","Carole" 
,"Jacquie","Gavin","Charles 
^ "Holly" 

50 NEXT a 


The +3 doesn't have to READ the DATA statements in order - it can be made to jump aboul' 
between DATA statements by using the RE S TORE command. The form of the command is. 


RESTORE xxx 


„Where ‘xxx’ is the line number of the DATA statement to be READ from. If you use the command 
RESTORE on its own (without a line number) the +3 will jump to the first DATA statement in the 
program, 


‘Type inand mun the following program... 


10 DATA 1,2,3,4,5 
20 DATA 6,7,8,9 
30 GO SUB 118 
40 GO SUB 110 
50 GO SUB 110 
60 RESTORE 20 
70 GO SUB 110 
80 RESTORE 

90 GO SUB 110 
100 STOP 

110 READ a,b,c 
120 PRINT a'b'c 
130 PRINT 

140 RETURN 


Thecommand GO SUB 118 calis a subroutine which READs the next three items of DATA and 
then PRINTsthem Notice how the RESTORE commandaffects which itemsare read. 


Delete line 80 and run this program again to see what happens 
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Part 7 
Expressions 


Subjects covered... 


Operations: +, -, *, / 
Expressions, scientific notation, variable names 


You have already seen some of the ways m which the +3 can calculate with numbers. It can perform 
the four arithmetic operations +, ~. * and / (remember that * 1s used for multiplication, and / в 
used for division), and it can find the value ofa variable, given its name. 


‘The example 
LET tax=sum*15/100 


illustrates that calculations can be combined. Such a combmation, like sum* 15 / 100, is called 
ап expression - so an expression is just а short-hand way of telling the +3 to do several calculations, 
one after the other. In our example, the expression sum* 15 / 100 means Took up the value of the 
vanable called s um, multiply it by 15. and divide by 100. 


In expressions containing *, /, +, =. multiplication and division are carried out first - they have a 
higher priority than addition and subtraction. Multiplication and division have the same priority as 
each other, which means that they are carried out in whichever order they appear in the expression 
(from left to right). The next operations to be carned out are addition and subtraction - these again 
have the same priority as each other and so, again, are carried out in order from left to right 


Hence in the expression 8-12 / 4 2*2, the first operation to be сатіеа out is the division 12/4 
which equals 3, so we can then represent the expressionas B 34 2 2 


The next operation to be carned out is the multiplicaton 2*2 which equals 4, so the expression then 
becomes 8344. 


Next to be carried out is the subtraction 8-3 which equals 5, so the expression becomes 5+4 
Finally, the addinon is carried out leaving the result 9 


‘Trythisout for yourself. Typem. 
PRINT 8-12/4+2%2 


A full list of the priorities of mathematical (and logical) operations will be found in part 31 of this 
chapter. 








You may, however, change the pnority of calculations within an expression by the use of brackets. 
Calculations withi= brackets are carned out first, so М ir, the above expression, you required ће 
addition 4+2 to be carried out first, you would enclose it in brackets. To see this, type in... 


PRINT 8-12/(4*2)*2 
„апа the result this time is4 instead of 9, 


Expressions are useful because, whenever the +3 ıs expecting a number from you, you can give it 
anexpression instead and it will work out the answer. 


Youcan also add together strings (or string variables) ina single expression. For example... 





nd puffy” 
30 LET c$-a$*b$ 
40 PRINT c$ 


We really ought to tell you what you can and cannot use as the names of variables. As we have already 
said, the name of a string variable has to be a single letter followed by $, and the name of the control 
variable in a FOR.. NEXT loop must be a single letter, however, the names of ordinary numeric 
variables are less restricted - they can use any letters or dits as long as the first one is a letter. You 
can put spaces in as well to make it easier to read, but they won't count as part of the name. Also, it 
doesn't make any difference to the name whether you type itin upper or lower case letters. There are 
‘some restrictions about variable names which are the same as commands, however. In general, ifthe 
variable containsa BASIC keyword init (with spaces around it) thenit won't be accepted. 


Here are some examples of the names of variables that are allowed. 


x 

any old thing 

the 

this name is impractical because it is too long 
tobeornottobe 

mixed cases spaces 

MixEdCASESSpACES 


(Note that these last two names (mixed cases spaces and MixEdCASEsSpAcES) are 
considered the same, and referto the same variable) 
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The following are not allowed as the namesof variables. 


pi (РІ isa keyword) 

any new thing (contains the separated keyword NEW) 

42t (begins with а dicit) 

2001 (contains digits only) 

to be or not to be (contains TO, OR and NOT, whichareall 
separated keywords) 

3 bears (begins with a digit) 

M*A*S*H (* isnota letter oradigit) 

Lloyd-Webber (7 15 nota letter ora digit) 


Numerical expressions can be represented by a number and exponent. Try the following to prove the 
point 


PRINT 2.34ей 
PRINT 2.34е1 
PRINT 2.34e2 


and so on up to 


PRINT 2.34e15 


PRINT aivesonly eight significant digits of a number, Try. 
PRINT 4294967295, 4294967295-429e7 


This proves that the computer can hold the digits of 4294967295, even though it is not prepared to 
display them allatonce. 


The +3 uses floatíng point arithmetic, which means that it keeps separate the digits of a number (ils 
mantissa) and the position of the point (thè exponent) This is not always exact, even for whole 
numbers Type... 


PRINT 1е10+1-1е10,1е10-1е10+1 


Numbers are held to about nine and a half digits accuracy. so 1e10 is too big to be held exactly right. 
The inaccuracy (actually about 2) is more than 1, so the numbers 1ё10 and 1еі0+1 appear to the 
computer to be equal. 


Foraneven more peculiar example, type 
PRINT 5е9+1-5е9 
Here the inaccuracy in 5e8 is only about 1, and the 1 to be added on in fact gets rounded up to 2. The 


numbers 5е9+ | and Se9+2 appear to the computer to be equal. The largest integer (whole number) 
that can be held completely accurately is 4,294,967, 294. 
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—————— 


"n 


The stung 
significant anc 


with no character at ай is calléd the empty or null string Remember that spaces are 
empty string is not the same as one containing nothing but spaces 





Try 


PRINT "Did you read "The Times" yesterday?" 


When you press ENTER you will aet the flashing red cursor that shows there ts a mistake somewhere 
in the line When the +3 finds ће double quotes at the beainmngof "The Times" it Imagines 
that these mark the end of the smng "Did you read " and и then сап! work out what 
The Times means 








There is a special device to get over this- Whenever you wish te write 
middle of a strmq you must write tt twice. hke tms 


а strmg quote symbol m the 





PRINT "Did you read ""The Times"" yesterday?" 


As you can see from What is printed on the screen, each double quote ts only really there once - you 
musthave to type twice to genit recoanised 
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Part 8 
Strings 


Subjects covered.. 
Slicing, using TO 


Given a stri 
Thus "cut" 
substrings 















substring ©! 1! consists ©! sony 
3 sibsting of “cutlery 


ecutive characte mit, taken їп 
but "cute" and "cruelty 


quence 
ате not 





Theres а notation 
expressions. The c 


ed slicing ‘or de: 


ral form is. 





substrinas алб 





п be applied to arbitrary string 





string expression (start T O fm 





so that forinstance 
"abcdef"(2 TO 5) 


isequalte bcde 


T you omit the start ther: £ 
Thus 





you omi the йз}. then the length of the stimg rs assumed 


"abcdef"( TO 5) isequaltoabede 
"abcdef"(2 TO )  tsequaltabcdef 
"abcdef"( TO ) i tcabcdef 





You ear reas" abcdef"() 





»wnte thi 





Aciahtly dit ni misses our the TO anu ust азоне mmber 





"abcdef"(3) tscquajto"abcdef"(3 TO 3) 1х 















Although normally overntiden, 
by anctherene ifthest 

"abcdef"(5 TO 7) 
givestheerror 3 Subscript wrong be rsand Te 





loo many, but 


"abcdef"(8 TO 7) 


——————— aaaaaaasssssssssssssssssssħĖŐȘ— 
wand... 


"abcdef"(1 TO 0) 


„аге both equal to the empty string "" andare therefore permitted. 


The start and finish must not be negative, or you get the error B integer out of 
range. Thisnext program tsa simple one illustrating some of these rules. 


10 LET a$-"abcdef" 
20 FOR n=1 TO 6 

38 PRINT a$(n TO 6) 
40 NEXT n 


Type NEW when this program has been run and enter the next program. 


10 LET a$-"1234567890" 

20 FOR n-1 TO 10 

30 PRINT a$(n ТО 10),a$((11-n) 
TO 10) 

40 NEXT n 


Forstring variables. wecan not only extract substrings, but also assign to them. For instance, type. 


LET a$="Velvet Donkey" 
,andthen, 

LET a$(8 TO 13) ="_ірѕжжжжжж"" 
and. 

PRINT a$ 


Since the substnng a$(8 TO 13) is only 8 characters long, only its first 6 characters 
(Lips**) аге used, the remaining 4 characters (# ++) are discarded. This is a charactenstic of 
assigning to substrings the substring has to be exactly the same length afterwards asit was before, To 
make sure this happens, the string that is being assigned to it is cut off оп the right if it is too long, or 
filled out with spaces if 1t 15 too short - this is called '"Procrustean assignment after the inn-keeper 
Procrustes who used to make sure that bis quests fitted their beds by either stretching them out on à 
rack or cutting their feetoff 








Complicated string expressions will need brackets around them before they can be sliced. For 
example... 


"abc"*"def"(1 TO 2) isequalto "abcde" 
("аБс"+"де?") (1 TO 2) isequalto " ab" 


Exercise. 


1. Try writing a program to print the day of the week using string slicing. (Hint - Let the string be 
SunMonTuesWednesThursFriSatur), 
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Part 9 
Functions 


Subjects covered... 


LEN, STR$, VAL, SGN, ABS, INT, SQR 
DEF FN 


Consider the sausage machine. You put a lump of meat in at one end, turn a handle and out comes a 
sausage atthe other end. A lump of pork gives а pork sausege. a lump of fish givesa fish sausage, and a 
lump of beefa beef sausage. 


Functions are practically indistinguishable from sausage machines but there is a difference; they 
work on numbers and strings instead of meat You supply one value (called the argument), тилсе it up. 
by doing some calculations on it and eventually get another value - the result. 


Meatin - Sausage Machine — Sausage ont 
Argumentm - Function — Resultout 


Different arguments give different results. and if the argument is completely imappropnate the 
function will stop and give an error report. 


Just as you can have different machines to make different products - one for sausages, another for 
combs, a third for dish cloths, and so on. different functions will do different calculations: Each will 
have itsown value to distinguish it from theothers. 


You use à function in expressions by typing its name followed by the argument, and when the 
expression is evaluated the result of the function will be worked out 


Asan example, there is a function called LEN, which works out the length of a string, Its argument js 
the string whose length you wish to find, and its results the length, so that if you type. 


PRINT LEN "Jammy Smears" 
the +3 will write the answer 12, 1e. the number of characters (including spaces) m the string 
Jammy Smears 


Ifyou mux functions and operations in a single expression, then the functions will be worked out before 
the operations. Again, however, you can circumvent this rule by using brackets. For instance, here 
ате two expressions which differ only in the brackets, and yet calculations are performed in an 
entirely different order m each case (although. asit happens. the end results are the same} 


LEN "Fred" + LEN "Bloggs" 
4+LEN "Bloggs" 

“+6 

18 








LEN ("Fred" + "Bloggs") 
LEN ("FredBloggs") 

LEN "FredBloggs" 

18 


Herearesome more funchons. 


STR$ converts numbers into strings. its argument is a number, and its result is the string that would 
appear on the screen if the number were displayed by a PRINT statement. Note how ils name ends 
ma $ sign to show that its result isa string. For example, you could say... 


LET a$- STR$ 1e2 


Which would have exactly the same effect as typing 
LET a$-"100" 


Or you could say. 


PRINT LEN STR$ 100.0000 
and get the answer 3, because STR$ 1@@.ЙЙЙЙ is equal to 100, the length of whichis 3 
characters. 
VAL islike S TR $n reverse~it converts strings into numbers. For instance. 


VAL. "3.5" 
sequal to the number 3.5 


VAL is the reverse of STRS because if you take any number, apply STR$ to it, and then apply 
VAL toit, you get back to the number you first thought of. 


However, if you take a string, apply VAL toit, andthenapply STR$ to it, you do not always get back 
to your original string: 


VAL isan extremely powerful function, because the string which is its argument is not restricted to 
looking like à plain number -it can be any numeric expression. Thus for instance, 


VAL "2*3" 
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is equal to 6. Even. 
VAL ("2"4"&3") 


„is equal to 6. There are two processes at work here. In the first, the argumentof V A L is evaluated as 
a string - the string expression " 2" +"! * 3" is evaluated to give the string "2*3", Then, the string 
has its double quotes stripped off, and what is left is evaluated as a number: so 2*3 is evaluated to 
give the number 6. 


There is another function, rather similar to VAL, though probably less useful, called VALS. lis 
argument is still a string, but its result is also a string. To see how this works, recall how VAL goes in 
two steps: first its argument is evaluated as a string, then the string quotes stripped off this, and 
whatever is left is evaluated as a number. With VALS, the first step is the same, but after the string 
quotes have been stripped off in the second step, whatever is left is evaluated as another string. 
Thus.. 


VALS """Ursula""" is equal to Ursula 


(Notice how the smng quotes proliferate again.) Try. 
LET a$="99" 





„and print all of the following VAL aS. VAL "aS", VAL """a$""" VALS a$. 
VALS "aS" and VALS """а$"""_ Some of these will work, and some of them won't -try to 
explainall the answers. 


SGN is the sign function (sometimes called signum). It is the first function you have seen that has 
nothing to do with strings, because both its argument and its result are numbers. The result is +1 ifthe 
arguments positive, 0ifthe argument is zero, and - ifthe argument is negative. 


ABS is another function whose argument and result are both numbers: It converts the argument into à 
positive number (which isthe result) by forgetting the sign, so that for instance. 


ABS -3.2 
,Isequalto 

ABS 3.2 
whichis simply equal to 3.2. 


INT stands for integer patt - an integer isa whole number. possibly negative This function converts 
a fractional number into an integer by throwing away’ the fractional part, so that for instance.. 


INT 3.9 


isequal to 3. 
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Be careful when you are applymg it to negative numbers, because it always rounds down, Thus for 
instance. 


INT -3.1 
is equal to -4, 


SAR calculates the square root of a number, ie. the result that, when multiplied by itself, gives the 
argument, for instance. 


SQR 4 


sls equal to because 2X 2 is equal to 4 
SQR 0.25 


,ISequalto 0.5 because 0 $x 0.5 is equal to 0.25. 
SAR 2 


isequalto 1,4142136 (approx) because |.4142136 x 1 4142136 1s equa! to 2 (almost), 


Ifyou multiply any number (even a negative one) by itself, the answer is always positive. This means 
that negative numbers do not have square roots, so if you apply SQR to a negative argument you get 
theerrorreportA Invalid Argument. 


‘You can also define functions of your own. Possible names for these are FN followed by a letter (ifthe 
result is a number) or F N followed by a letter followed by $ (if the resultas a string). These functions 
are much stricter about brackets - the argument must be enclosed m brackets. 


You define a function by puttmg a DE F statement somewhere in the program. For instance, here is 
the definition ofa function FN s whose result isthe square of the argument... 


18 DEF FN s(x)7x*x: REM the sq 
uare of x 


The s following the DEF FN isthe name of the function. The x in brackets isa name by which you 
wish to refer to the argument of the function You can use any single letter you like for this (or, if the 
argumentisa string, a single letter followed by $). 


After the = sign comes the actual definition of the function. This can be any expression, and it can also 
refer to the argument using the name you've given il (in this case, x) as though it were an ordinary 
variable. 





When you have entered this line, you can invoke the function just like one of the +3's own functions, 
by typing its name, FN s, followed by the argument Remember that when you have defined a 
function yourself, the argument must be enclosed m brackets. Try ii outa few times. 


PRINT FN s(2) 
PRINT FN s(3*4) 
PRINT 1+ INT FN s ( LEN "сһіскеп"/2+3) 


Once you have put the corresponding DEF statement into the program, you can use your own 
functions in expressions justas freely as you can use the computer's 


INT always rounds down. To round to the nearest integer, add 0,5 first - you could write your own 
function to do this. 


20 DEF FN г(х)= INT (х+0.5): R 
EM gives x rounded to the n 
earest integer. 


Youwill then get, for stance. 


FN r(2.9) isequalto3 
FN r(2.4) 1sequalto2 
FN r(-2.9)  isequalto-3 
FN r(-2.4)  isequalto-2 


Compare these with the answers you will get when you use INT instead of ЕМ г Type in and run 
the following. 


10 LET х=й: LET y=@: LET a=10 
20 DEF FN р(х,у) =а+хжу 

30 DEF FN q()=atxey 

00 PRINT FN p(2,3), FN qO 


There are a lot of subtle points in this program. Firstly, a function is not restricted to just one argument; 
Itcan have more, or even none at all - but you must still always keep the brackets. 


Secondly, it doesn't matter whereabouts in the program you put the DEF statements After 
the +3 has executed line 10, it simply skips over lines 20 and 30 to get to line 40. They do, however, 
have to be somewhere in the program -they can'tbeina command. 





Thirdly, x and y are both the names of vanables in the program as a whole, and the names of 
arguments for the function ЕМ p. FN. p temporarily forgets about the variables called x and y, but 
since it has no argument called a, it still remembers the variable a. Thus when FN p(2,3) is 
being evaluated, a has the value 10 because itis the vanable, x has the value 2 because itis the first. 
argument, and y has the value 3 because it is the second argument. The result is then. 10*2*3 
which is equal to 16 When РМ q() is being evaluated. on the other hand, there are no arguments, 
so a, x and у all still refer to the vanables and so have the values 10, 0 and 0 respectively. The answer 
inthis case is 1@+Й@ *@ whichis equal to 10 








Now change line 20 to. 
20 DEF FN p(x,y)* FN qO 


‘Ths time, FN. p(2,3) will have the value 10 because FN q will still go back to the variables х 
and y rather than using theargumentsof FN p. 
Some BASICs(not +3 BASIC) have functionscalled LEF T$, RIGHTS, MIDS and TL$. 
LEFT$(a$,n) awesthesubstringof a $ consisting of the first n characters. 
RIGHTS (a$ ,n) civesthe substring of a$ consisting of the characters from nth on. 
MID$(a$,n1,n2) givesthesubstringof a$ consisting of n2 characters, starting at the n1th 
TLS (a$ ) givesthe substring of a $ consisting of al!'its characters except the first, 
You can write some user-defined functions to do the same.. 

10 DEF FN t$(a$)-a$(2 TO ): RE 

M TLS 


20 DEF FN ($Ca$,n)=a$( TO n): 
REM LEFTS 


Check that these work with strings of length 0 or 1. Note that our FN. L$ has two arguments, one à 
number and the other a string, A function can have up to 26 numeric arguments (why 26?) and at the 
same time up to 26 stringarguments. 


Exercise 

Use the function РМ s (x) =x*x totest SAR. Youshould find that. 
FN sC SQR x) 

equals x if you substitute any positive number for X, and. 
SQR FN s(x) 


equals ABS х whether x is positive or negative (Why ts the ABS there”). 
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Part 10 


Mathematical functions 
Subjects covered... 


| 
Р1,ЕХР,ЬМ,$1М,С0$,ТАМ,А$М,АС$,АТМ 


"This section deals with the mathematics that the +3 can handle. Quite possibly you will never have 
to use any of this at all, so if you find it too heavy going, don't be afraid of skipping it, It covers the 
operation | (raising to a power), ће functions EXP and LN, and the tngonometncal functions SIN, 
COS, TAN and their inverses ASN, ACS, and АТМ. 


| and EXP 


You can raise one number to the power of another. This means ‘multiply the first number by itself the 
second number of times’, This ts normally shown by writing the second number just above and to the 
night of the first number; but obviously this would be difficult on a computer so we use the symbol | 
instead. For example, the powers of Zare 


21 lequals2 

2 1 2equals2 x2 equals 4 (2 squared. normally written 2) 

2] Sequals 2x2 x2 equals 8 (2 cubed, normally written 2°) 

2 1 4equals2x2x2x2 equals 16 (2 to the power of four, normally written 2") 
«and soon. 


Thus, at its most elementary level, а { b means ‘a multiplied by itself b times’, but obviously this only 
makes sense if b 15 a positive whole number. To find a definition that works for other values of b, we 
consider the rule 


а 1 (b+c)equalsa f bxa c 


(Notice thatwe give à higher pnority than multiplication and division so that when there are several 
operahons in one expression. 1 is evaluated before * and /). You should not need much convincing 
that this works when band care both positive whole numbers; but if we decide that we want it to work 
even when they are not, then we find ourselves compelled to accept that. 


a f Oequals 1 
af (b)equals Ia | b 
а | (1/b) equaisthe bth rootof a. which isto say. the number that you have to multiply by itself b hmes to geta. 


and 


a f (bxc)equals(a f b) tc 





———_——— 


If you have never seen any of this before then don't try to remember it straight away, just remember 
that... 


a1 (-l)equals Va 
„апа... 


а { (1/2) едиаіѕ SQRa 
and maybe when you are familiar with these, the rest will begin to make sense. 
Experiment with all this by trying this program. 


10 INPUT a,b,c 
20 PRINT ax(b+c),atb*afc 
30 GO TO 10 


Of course, if the rule we gave earlier is true, then each time round, the two numbers that 
the +3 printsout will be equal. (Note - because of the way the computer works out  , the number on 
the left, a in this case, must never be negative.) 


A rather typical example of what this function can be used for is that of compound interest, Suppose 
you keep some of your money in a building society and they give 15% interest per year. Then after one 
year you will have not just the 100% that you had anyway, but also the 15% interest that the building 
Society has given you, making altogether 115% of what you had onginally. To put it another way, you 
have multiplied your sum of money by 1.18, and this is true however much you had there in the first 
place, After another year, the same will have happened again, so that you will then have 1.13 x 1.15, or 
in other words, 1.15 } 2, or in other words, 1.3225 times your onginal sum of money. In general then, 
after y years, you will have 1.15 f y times what you started out with. 


Ifyou try this command. 


FOR y=@ TO 100: PRINT y,10*1.15]y: NEXT у 
you will see that even starting off from just £10, t all mounts up quite quickly, and what's more, it gets 
faster and faster as time goeson (though you might still find that it doesn't keep up with inflation). 


‘This sort of behaviour, where after a fixed interval of time some quanhty multiplies itself by a fixed 
proportion, is called exponential growth, and it is calculated by raising a fixed number to the power of 
the time. 


Suppose you did this. 
10 DEF FN а(х) =ајх 


Here, a is more or less fixed, by LET statements- its value will correspond to the interest rate, which 
changesonly every sooften. 
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There isa certain value for a that makes the function ЕМ a look especially pretty to the trained eye 
ofa mathematician; and this valueiscallede The +3 hasa functioncalled EXP defined by... 


EXP xisequaltoe fx 


Unfortunately, е uself is not an especially pretty number. 1 ıs an infinte non-recurring decimal You 
can see tts first iew decimal places by typing. 


PRINT EXP 1 


because EXP 1 is equal to e f | which is equal to е Of course. this is just an approxunation, You 
can never write down e exactly. 


LN 


‘The inverse of an exponential function isa logarithmic function - the logarithm (to base а) of a number 
X15 the power to which you'd have to raise а to get the number х, and this 1s written log,x. Thus by 
definition, а } log,x is equa! tox, and itis also true that log (a f x):s equal tox. 


You may well already know how to use base 10 logarithms for doing multiplications; these are called 
common logarithms. The +3 has a function LN wtuch calculates logarithms to the base e: these are 
called natural logarithms. To calculate logarithms to any other base, you must divide the natural 
logarithm by the natural logarithm of the base. te log.xisequaltoLN x/LN a 


PI 


Given any circle, you can find its perimeter (the distance round its edge - often called its 
circumference) by multiplying its diameter (width) by a number called т.т (pronounced pi) is the 
Greekequivalentofthe Engliiletter p, and it is used because t stands for perimeter 


Like е v is an infinite non-recurring decumal - it starts off as 31415927. The word РІ on the 43 is 
lakenas standing for ths number. Try. 


PRINT PI 





SIN COS and TAN, ASN ACS and ATN 


These trigonometrical functions measure what happens when a point moves round a сисје Here isa 
circle of radius | (1 what? may ask - tt doesn't matter. as Jong as we keep to the same unit al! the 
way through) and a point moving топам The рот! started atthe 3a'clock' position. and then moved 
round man anti-clockwise direction 












distance moved 
around evcle=a 


axis 


starting position 
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We have also drawn in two lines called axes through the centre of the circle. The one through 3o'clock 
is called the x-axis, and the one through 120'clock is called the y-axis. 


To specify where the point is, you say how far it has moved round the circle from its 3 o'clock starting 
position: let us call this distance a. We know that the circumference of the circle is 2л (because its 
radius is | and its diameter is thus 2); so when it has moved a quarter of the way round the circle, a is 
equal to 7/2; when it has moved halfway round, a is equal to л; and when it has moved the whole way 
round, ais equal to 2л. 


Given the curved distance round the edge - a, two other distances you might like to know are how far 


the point is to the night of the y-axis, and how far it 1s above the x-axis. These are called, respectively, 
the cosine and sine ofa. The functons COS and SIN onthe +3 willcalculate these. 


vanis 






cosine о! з= СОЅ a 





sine of a 
*SIN а“ 





Note thal if the point goes to ће Іей of the y-axis, then the cosine becomes negative, and if the point 
goes below the x-axis, the sine becomes negative. 


Another property is that once а has get up to 27, the point is back where it started and the sine and 
cosine start taking the same values all over again ie. SIN (a*2*PI) equals SIN а and 
COS (a+2*PI) equalsCOS а 


The tangent of a is defined as being the sine divided by the cosine; the corresponding function on the 
+3 iscalled TAN. 


Sometimes we need to work these functions out ш reverse, finding the value of a that has given sine, 
cosine or tangent. The funchons to do this are called arcsine (ASN ол ће +3), arccosine (ACS) and 
arctangent (АТН). 


In the diagram of the point moving round the circle, look a! the radius joing the centre to the pomt: 
You should be able to see that the distance we have called a (the distance that the point has moved 
round the edge of the circle) is a way of measuring the angle through which the radius has moved 
away from the x-axis. When à is equal to 7/2, the angle is 90 degrees; when a is equal to 7 the angle is 
180 degrees, and so on, round to when a is equal to 27, and the angle 1s 360 degrees, You might just as. 
well forget about degrees, and measure the angle in terms of a alone; we say then that we are 
measuring theangle m radians. Thus 7/2 radians is equal to 90 degrees and so оп. 


You must always remember that on the +9, the functions SIN, COS, etc. use radians and net 
degrees. To convert degrees to radians, divide by 180 and multiply by т; to convert back from 
radians to degrees, you divide Бу 7 and multiply by 180. 
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Part 11 
Random Numbers 


Subjects covered... 


RANDOMIZE 
RND 


This Section deals with the keywords RNO and RANDOMIZE 


In. some ways RND is like a function - it does calculations and produces a result. It is unusual m thatit 
does not need an argument. 


Each time you use it, its result is a new random number between 0 and |. (Sometimes it can take the 
value 0, but never L) 


Try. 


10 PRINT RND 
20 GO TO 10 


to see how the answer vanes Can you detect any pattern? You shouldn't be able to - random means 
that there is no pattern 


Actually, RND is not truly random, because it follows a fixed sequence of 65536 numbers, However, 
these are so thoroughly jumbled up that there are at least no obvious patterns, and we say that RND is 
pseudo-random 


RND gives а random number between 0 and |. but you can easily get random numbers in other 
ranges. For instance, 5#RND is between 0 and 5, and 1. 3*8 . 7 *RND is between | 3and 2 To 
get whole numbers use INT (remembenng tha! INT always rounds down) as in 
1*INTCRND*Ó) which we shall use ma program to simulate dice. RND*6 isin the range 0106. 
but since it never actually reaches& INT (RND*6) 10. 1.23.4015 


Here isthe program. 


10 REM dice throwing program 
20 CLS 

30 FOR n=1 TO 2 

40 PRINT 1+ INT ( RND *6);" "; 
50 NEXT n 

60 INPUT a$: GO TO 20 


Press ENTER each time you wish to throw the dice 
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The RANDOMIZE statement may be used to make RND start off at a definite place m its sequence 
ofnumbers, as you can see with this program... 


10 RANDOMIZE 1 

20 FOR n=1 TO 5: PRINT RND ,: 
NEXT n 

30 PRINT : GO TO 10 


After each execution of RANDOMIZE 1, the RND sequence starts off again with 0,0022735896. 
You can use other numbers between 1 and 65535 in the RANDOMIZE statement to start the RND 
sequence offat different places. 


Ifyou had a program with RN D init and if also had some mistakes that you had not found, then it would 
help to use RANDOM I ZE like this so that the program behaved the same way each time you ran it, 


RANDOMIZE used on its own (or RANDOMIZE 0) have a different effect - they really do 
randomise RND - you can see thisin the next program. 


10 RANDOMIZE 
20 PRINT RND : GO TO 10 


The sequence you get here is not very random, because RANDOMIZE uses the time since 
the +3 was switched оп As this has gone up by the same amount each time that RANDOMIZE is 
executed, the next RN D does more or less the same. You would get better randomness by replacing 
GO TO 10byGO TO 20 


Here i58 program to (oss coins and count the numbers of heads and tails.. 


10 LET heads=@: LET tails=@ 

20 LET coi INT ( RND *2) 

30 IF coin-Ü THEN LET heads=he 
ads+1 

40 IF coin=1 THEN LET tails=ta 
ils+1 

50 PRINT heads;",";tails, 

60 IF tails <> @ THEN PRINT he 
ads/tails; 

70 PRINT: GO TO 20 





The ratio of heads to fails should become approximately 1 if you go on long enough, because tn the 
long run you expect approximately equal numbers of headsand tails, 


Exercise. 
| Choose a number between і and 872 anti type 
RANDOMIZE yournumber 


ere 
Note that the next value of RND will be. 


(75* Gyournumber* 1) -1)/65536 


Try thisoutior yourself. 








Part 12 
Arrays 


Subjects covered.., 


Arrays 
DIM 


Suppose that you have a list of numbers - tor mstance, the marks of ten people ina class. To store them 
inthe +3 you could use the variables m 1, m2, m3... and so on up to m1, but the program to set up 
these ten Variables would be rather long and tedious to type in. 1e. 


10 LET 
20 LET 
30 LET 
40 LET 
50 LET 
60 LET 
70 LET 
80 LET 
90 LET 
100 LET 





Instead, there is a mechanism, known as an array whereby you may specify a variable which (instead 
of containing а single value as variables normally do) may contain a number of separate elements, 
each of which may contain different values. Each element is referenced by an index number (the 
subscript) wntten in brackets after the vanable name. For the above example, the array variáble's 
name could be m - (the name of an array variable must bea single letter), and the ten vanables would 
thenbem CT), m C2), м3). andsoonupto m C18) 


The elements ofan array are called subscripted variables. as opposed to the simple vanables that you 
are already familiar with. 


Before you can use an array, you must reserve some space for itinthe +3's memory, and уоп do this 
by using the keyword D I M (for dimension). The statement. 


DIM m(10) 


„sets up an апау called m whose dimensions are 10 (ie there are 10 subscnpted variables). The 
DIM statement initialises each element in the array to zero. It also deletes any array called m that 
existed previously - (however, it doesn't delete any simple variable called m. Ar array variable сап 
coexist alongside a simple numerical variable of the same name because the апау can always be 
distinguished by its subscript) 
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The array elements subscnpts may be represented by any numencal expression yielding a valid 
subscnpt number. This means that an array can be processed usmg а FOR..NEXT loop. Thus, 
instead of the above long-winded program, we can now set up the variables m(1)..m(10) 
using. 


18 DIM т(10) 

20 FOR n=1 TO 10 

30 READ m(n) 

40 NEXT n 

50 DATA 75 „44,90,38,55,64,70,1 
2,75,60 


1o READ mtheelements valuesírom a DAT A list, or 


10 DIM m(10) 

20 FOR n=1 TO 10 
30 INPUT m(n) 

40 NEXT n 


„10 INPUT theelements values by hand 


Note that the D I M statement must come before any attempt to access the array ina program. 
Ifyou wish, you may examine the contents of the array using. 


10 FOR n=1 TO 10 
20 PRINT m(n) 
30 NEXT n 


..or individually using... 


PRINT m(1) 
PRINT m(2) 
PRINT m(3) 


etc, 


You can also set up arrays with more than one dimension: In a two dimensional array you need two 
numbers to specify an element - rather like the line and column numbers that specify a character 
position on the screen. If you imagine the line and column numbers (two dimensions) as referring toa 
printed page. you could then, for example, have an extra dimension to represent the page numbers: 
Think of the elements of a three dimensional array V as being specified by V (page number, line 
number , column number) 





For example, to ве! up a two-dimensional array с with dimensions 3 and 6, you use the DIM 
statement... 
DIM c(3,6) 
This then gives you 3x67 18 subscnpted vanabies. 
с(1,1), с(1,2)юс(1,6) 
с(2,1), c(2,2).10c(2,6) 
c€(3,1), с(3,2)..ос(3,6) 
The same principle works for any number of dimensions. 


Although you can have a number and an array with the same name, you cannot have two arrays with 
the same name, even if they havea different number of dimensions 


There are also string arrays. The strings in an array differ from simple strings їп that they are of fixed 
length and assignment to them is always Procrustean (ie. chopped off or padded with spaces), 


The name ofa string array isa single letter followed by $. Unlike numenc arrays, a string array anda 
simple stning variable cannot have the same name. 


Suppose then, that you wantan array a $ of five strings. You must decide how long these strings are to 
Бе -letus suppose that 10 characters foreach elementis long enough. You then say... 


DIM a$(5,10) (type thisin) 

This sets upa 8х10 array of characters, but you can also think of each row as beinga string... 
a$(1) equalsa$(1,1) a$(1,2) toa$(1,10) 
a$(2) equalsa$(2,1) а$(2,2). {оа$(2,10) 
a$(3)equisa$(3,1) a$(3,2).10a$(3,10) 


a$(4)equisa$(4,1) a$(4,2) .10a$(4,10) 
a$(5) equalsa$(5,1) a$(5,2) .10a$(5,10) 


If you give the same number of subscnpts (two in this case) as there were dimensions in the D IM 
statement, then you get a single character, but if you miss the last one out, then you get a fixed length 
string. So, for instance, а$(2,7) is the 7th character in the string a$(2) Using the slicing 
notation, we could also write thisas a $ (2) (7 ). Now type. 

LET а$%(2) ="1234567890" 
„and. 

PRINT a$(2), a$(2,7) 
Youget 

1234567898 7 
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For the last subscript (the one you can miss out), you canalso have a slicer, so that for instance, 
a$(2,4 TO B)iequaltoca$(2) (4 TO 8) isequalto"45678" 


Remember - Inastring апау, all the strings have the same fixed length. 


The D IM statement has an extra number (the last one) to specify this length. When you write down à 
subscripted vanable for a string array, you can put man extra number (а slicer) to correspond with ће 
extra number inthe D I M statement 


Youcan have string arrays with no extra dimensions. Type. 


DIM a$(10) 


and you will find fhat a $ behaves just like à string vanable, except that it always has length 10, and 
assignment to it is always Procrustean. 


Exercise, 


| Use READ and DATA statements to set up an array m$ of twelve strings in which т$ (n) isthe 
name of the nth month. (Hint- The DIM statement will be DIM m$(12,9). Testit by pnnüng 
out all the values of m$ (т) (usea loop). 








Part 13 
Conditions 


Subjects covered... 


AND,OR 
NOT 


We saw in part 3of ths chapter how an I F statement takes the form... 


І Р condition THEN.. 
The conditions there were the relations =, <, >, <=, >= and <> which compare two numbers or two 
strings. You can also combine several of these, using the logical operations: AND, OR and NOT. 
One relation AND another relation is true whenever both relations are true, so you could have a line 
like. 


IF a$="yes" AND x>@ THEN PRINT "result" 


„in Which result gets printed only if a$ s equal to yes and x is greater than zero, The BASIC 
here is so close to English that it hardly seems worth spelling out the details. Asin English, you can join 
lots of relations together with AND, and then the whole lot is true fall the individual relations are. 


One relation OR another is true whenever at least one of the two relations is true. (Remember that t is 
still true if both the relations are true - thisis something that English doesn't always imply.) 


The NOT relationship turns things upside down. The NOT relation is true whenever the relation is 
false. and false whenever itis true 


Logical expressions may use combinations of AND. OR and NOT, just as numerical expressions may 
use combinations of +, =, * and so on. You can even put them in brackets if necessary. Logical 
operations have priorities in the same way as +. ~. *, / and } do. NOT has the highest pnority, then 
AND then OR. 


NOT is really a funchon. with an argument and a result, bat its prionty is much lower than that of other 
functions, Therefore, its argument does not need brackets unless it contains AND or OR (or both), 
NOT a=bmeansthesameasNOT (a=b) (andthe sameas a <> ofcourse), 


<> isthenegationof = inthe sense thatitis true only if = is false. In other words... 
a<>bisthesameasNOT a=b 

.andalso. 
NOT a<>bisthesameasa=b 


Convince yourself that >= and <= are the negations of < and > respectively, Thus you can always 
get rid of NOT from in frontofa relation by changing the relation. 
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Also, 

NOT (a first .oqical expression AND a second) 

asthe sameas... 

NOT (thefirst) OR NOT (thesecond) 
«апа. 

NOT (a first logical expression OR a second) 
„isthe sameas. 

NOT (thefirst) АМО NOT (the second) 


Using this, you can work NO Ts through brackets until eventually they are all applied to relations, and 
then you can get nd of them. Logically speakıng, NOT ts unnecessary, although you might still find 
that using it makes a program clearer 


‘The following section is quite complicated, and can be skipped by the faint-hearted! 
Try. 
PRINT 1=2,1 <> 2 


which you might expect to give a syntax error. In fact, as far as the computer is concerned, there 1s 
nosuch thing аз locical value - instead it uses ordinary numbers, subject to a few rules... 


(i) =, €, >, <=, >= and <> all qwe the numenc results 1 for true, and 0 for false. Thus, the PRINT 
command above printed 0 for 1 22. whichis false, and | for !<>2, whichis true. 


(ii) In the statement. 


TF condition THEN. 


„ће condition can be actually any numeric expression. If its value is 0, then it counts as false, and any 
other value (including the value of 1 that a true relation gives) counts as true. Thus the I F statement 
means exactly the same as.. 


IFcondinon <> @ THEN 


(ii) AND, ORand NOT arealso number-valued operations... 


x. ify istrue (non-zero) 
х AND yhasthevaiue -Oaze ty sake (e) 


1 (true). if y is true (non-zero) 
х OR yhasthevalue X ay isfalse (zero) 


O (false), if x 1s true (non-zeto) 


NOT x hasthevalue I (trae), £x 1s alse (cero) 


(Notice that true’ means non-zero when we're checking а given value. but it means | when were 
producing 4 new one). 
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—— aaaaaaaaaaaaaaaaaaaiIiIaaasssasssiÅ 
Now try this program... 


10 INPUT a 

20 INPUT b 

30 PRINT (a AND a >= b)*(b AND 
а< b) 

48 GO TO 10 


Each time it prints the larger of the two numbers a and b. 
Convince yourself that you can think of. 


x AND y 
as meaning, 
X ify (else the resultis0) 
andol 
x OR y 
asmeaning, 
x unless y (in which case the resultis 1) 
An expression using AND or OR like this is called a conditional expression. An example using OR 
could be 
LET totalzprice less tax*(1.15 OR v$="zero rated") 


Notice how AND tends to go with addition (because its default value 15 0), and OR tends to go with 
multiplication (because its default value is 1). 


Youcan also make stnng valued conditional expressions, but only using AND, 


X$ AND y hasthevalye i see 


soi means x $ ify (else the empty string). 
Try tis program. which inputs two strings and puts them im alphabetical order 


10 INPUT "type in two strings" 
'aS,b$ 
20 IF a$> b$ THEN LET c$-a$: L 
ET a$-b$: LET b$-c$ 
30 PRINT a$;" ";("«" AND a$« b 
5)+("=" AND a$-b$);" ";b$ 
48 60 TO 10 


=. ses 
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Part 14 
The Character Set 


Subjects covered... 


CODE, CHRS 
POKE, PEEK 
USR 
BIN 


The letters, digits, spaces. punctuahon marks and so on that can appear in strings are called 
characters, and they make up the character set that ће +3 uses Most of these characters are single 
symbols, but there are some more, called tokens, that represent whole words, such as PRINT 
STOP, <> andsoon. 





There are 256 characters, and each one has a code between 0 and 255 (there 1sa complete list of them 
in part 28 of this chapter), To солу n codes and characters, there are two functions, CODE 
and CHRS. 

CODE is applied to а string, and giy 
empty) 
CHR$isapplied to 








s the code of the first charac 





тїп the string (or 0 if the string i$ 





umber, and gives the si haracter string whose code is that number, 











This program prints out the entire character sel. 


10 FOR a=32 TO 255: PRINT CHRS 
a;: NEXT a 


Onthe sc 





en will appear the following. 








— 


As you can see, the character set consists ofa space, 15 symbols and punctuation marks, the ten digits, 
seven more symbols, the capital letters, six more symbols, the lower case letters and five more 
symbols. These are all (except £ and ©) taken from a widely-used set of characters known as ASCI 
(American Standard Codes for Information Interchange). ASCII also assigns numeric codes to these 
characters and these are the codesthatthe +3 uses. 


The rest of the characters are not part of ASCII, but are dedicated to the ZX Spectrum range of 
computers. First amongst them are a space and 15 patterns of black and white blobs. These are called 
the graphics symbols and can be used for drawing pictures. You can enter these from the keyboard, 
using what's known as graphics mode. Pressing the GRAPH key switches on graphics mode, after 
which the keys 1, 2 3, 4, 5, 6, 7 and 8 will produce the graphics symbols. 


PEPE ear | 
= 
ЕТ | 





































































































While in graphics mode, pressing CAPS SHIFT together with one of the keys 1 to 8 produces 
"inverted versions of the same symbols, ie. black becomes white and white becomes black. 


Ba Р ьа) 
J| [LT T | TTT I 
СЕЕ 
ко LITT TIT TT e 


[ | 


The cursor keys won't work properly while all this is gangon as the +3 interprets them as shifted 
number keys, and prints graphics characters accordingly, 


Pressing the 9 key turns everything back to normal (as does pressing GRAPH again), The Ø key 
deletes the character to the left of the cursor 
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Here are the sixteen graphics symbols. 


Symbol Code Symbol Code 
28 143 
129 142 


141 


140 


Ы a” m al CS | 
"|ы ЫШ 


After the graphics symbols 1п the character set, you will see what appears to be another copy of the 
alphabet from A to S. These are characters that you can redefine yourself (though when the machine is 
first switched on they are set as letters) - they are called user-defined graphics. You can type these in 
from the keyboard by going into graphics mode, and then using the letter keys A toS. 





To define a new character for yourself, follow this recipe -it defines a character to show л. 
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(1) Work out what the character looks like. Each character has an 8 x 8 grid of dots, each of which сап 
appear fo be either on or off You'd draw a diagram something like this (with black squares 
representing the dots whichare on), 





When a dot is on, the +3 рппі the ink colour, when a dot is off. the +3 prints the paper colour, 
(The terms ink and paper are explained in part 16 of this chapter.) 


We've left а one-square border around the edge of the character because all the other letters also 
have one (except for lower case letters with tails, where the tail goes right down to the bottom), 


(ш) Work out which user-defined graphic you wish to display т - let's say the one corresponding to P. 
so thataf you press P (after pressing GRAPH) you get л. 


(ш) Store the new pattern Each user-defined graphic has its pattern stored as eight numbers, one for 
each row. You can write each of these numbers in a program as ВІН followed by eight Охот I's - 0 for 
paper, | forink -so the eight numbers for our л character are 


BIN 8000880900 -toprow 

BIN 00000000 -secondrowdown 
BIN 00000010 -third row down 
BIN 00111100 -fourthrowdown 
BIN 01010100 -ñfthrowdown 
BIN 00010100 -sixthrowdown 
BIN 00010100 -seventhrowdown 
BIN 00000000 -botomrow 


(If you know about binary numbers. then it should help you to know that BIN 1s used to write a 
number in binary instead of the usual decimal) Look at the pattern of binary numbers through 
half-closed eyes - you may even be able to see the s character 


These eight numbers are stored in eight locations (bytes) in memory. Each of these locations has an 
address. The address of the first byte (or group of eight digits) is USR "Р" (we chose P in (ii) 
above) The address of the second byte is USR "P"+1, and soon up to the eighth byte, which has 
the address USR "Р"+7 
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USR here isa function to convert a string argument mto the address of the first byte m memory for the 
corresponding user-defined graphic. The sting argument must be a single character which can be 
either the user-detned graphic itself or the corresponding letter (in upper or lower case). There is 
another use for USR, when itsargumentisa number, which will be dealt with later. 


Evenif you don't understand this, the following program will define the character for you 


10 FOR п=0 TO 7 

20 READ row: POKE USR "Р"+п, г 
ow 

30 NEXT n 

40 DATA BIN 00000000 

50 DATA BIN 00000000 

60 DATA BIN 00000010 

70 DATA BIN 00111100 

80 DATA BIN 01010100 

90 DATA BIN 00010100 

100 DATA BIN 00010100 

110 DATA BIN 00000000 


The POKE statement stores a number directly m a memory location, bypassing the mechanisms 
normally used by the BASIC The opposite of POKE is PEEK, and this allows us to look at the 
contents of a memory location although it does not actually alter the contents themselves. PEEK and 
РОКЕ are descnbed more fully m part 24 ofthis chapter 


After the user-defined graphies in the character set come the tokens. 


You will have noticed that we have not printed ош the first 32 characters (codes 0 to 31) - these are 
control characters. They доп! produce anything printable. but instead are used to control the screen, 
display or some other functionofthe +3. 


(If you try to print control characters. the +3 displays ? to show that it doesn't understand them 
Control characters are described more fully m part 28 of this chapter ) 


The three contro! characters that the screen display uses аге 6 8 and 13 (these will now be 
explained) Onthe whole, CHR$ 8 isthe only one youare likely to find useful 





CHR$ 6 prints spaces in exactly the same way as а comma does in a PRINT statement, for 
instance. 


PRINT 1; CHRS 6;2 
doesthe same as 


PRINT 1,2 


Obviously thisis nota very Clear way of usinait. A more subtle wayas ta say. 





LET а$="1"+ CHRS 6+" 
PRINT a$ 
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СНК 8 is'backspace -it moves the print position back one place. Try, 


PRINT "1234"; CHR$ 8;"5" 
which prints out. 


1235 


CHRS 131s newline - it moves the print position to the beginning of the next Ime. 


The screen display also uses contro! codes 16 to 23 - these are explained in parts 15 and 16 of this 
chapter (all the codesare listed in part 28). 


Using the codes for the characters we can extend the concept of ‘alphanumencal ordenng to cover 
strings containing any characters, not just letters. If instead of thinking in terms of the usual alphabet of 
26 letters we use the extended alphabet of 256 characters, in the same order as their codes, then the 
principle i$ exactly the same. For instance, the following strings are in their ‘Spectrum’ ASCII 
alphabetical order, (Notice the rather odd feature that lower case letters come after all the capitals; so 
а comesafter Z. Noticeaiso that spaces are significant ) 


CHR$ 3+"ZOOLOGICAL GARDENS" 

CHRS B*"AARDVARK HUNTING" 

" AAAARGH!" 

"(Parenthetical remark)" 

"199" 

"129.95 inc. МАТ" 

"AASVOGEL' 

"Aardvark" 

"Elgar, the Regal Lager" 

"PRINT" 

"Zoo" 

"Cinterpolation]" 

"aardvark" 

"aasvogel" 

"derby" 

"200" 

"zoology" 
Here is the rule for finding out in which order two strings come. Start by comparing the first two 
characters. If they are different, then one of them has its code less than the other, and the string it 
comes from is the earlier (lesser) of the two strings. If they are the same, then go on to compare the 
next two characters. [f in this process one of the strings runs ош before the other, then that string 1s the 
earlier; otherwise they must be equal. 


The relations =, €, >, <=, >=, and <> ere used for strings as well as for numbers: < means comes 
before and > means comesafier , so that. 


"АА man"«"AARDVARK" 
"AARDVARK">"AA man" 


ware both tme: 
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<= and >= work the same way as they do for numbers, so that. 
"The same string" <= "The same string" 


vis true, but.. 
"The same string" < "The same string" 


„is false. 
Experiment onall tms using the program here, which inputs two strings and puts them in order. 


10 INPUT "Type in two strings: 
",a$,b$ 

20 IF a$» b$ THEN LET c$-a$: L 
ET a$-b$: LET b$=c$ 

30 PRINT a$;" "; 

40 IF a$« b$ THEN PRINT " 
G0 TO 60 

50 PRINT "="; 

60 PRINT " ";b 

70 GO TO 10 


Note (in the above program and also m the program at the end of part 13) how we have to introduce 
c$ inline 20 when we swap over a $ and b$. Can you see why simply using. 








LET a$=b$: LET b$-a$ 
would not have the desired effect? 
The next program sets up user defined graphics for the following keys to display chess pieces. 


Bor bishop. 
Kforking 
Rfor rook 
Qlor queen 
Pforpawn 
Nfor knight 


Chess pieces. 


5 LET b=BIN 01111100: LET c-B 
IN 00111000: LET d-BIN 0001 
0000 

10 FOR п=1 TO 6: READ p$: REM 
6 pieces 

20 FOR fzÜ TO 7: REM read piec 
es into 8 bytes 
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30 READ a: POKE USR p$*f, a 
40 NEXT f 
50 NEXT n 
100 REM bishop 
110 DATA "b", 0, d, BIN 0010100 
0, BIN 01000100 

120 DATA BIN 01101100, c, b, ё 

130 REM king 

140 DATA "К", 0, d, c, d 

150 DATA c, BIN 01600100, c, 0 

160 REM rook 

170 DATA "г", Q, BIN 01010100, 
Bs- Е 

180 DATA c, b, b, Ø 

190 REM queen 

200 DATA "q", Q, BIN 01010100, 
BIN 00101000, d 

210 DATA BIN 01101100, b, b, Ø 

220 REM pawn 

230 DATA "p", Ø, 0, d, с 

240 DATA c, d, b, @ 

250 REM knight 

260 DATA "n", 0, d, c, BIN 0111 
1000 

270 DATA BIN 00011000, c, b, Ø 


Note thatin the above DA T A statement: havesimply used Oinsteadof BIN 00000000 


When you hi rogram, you may look at the pieees by pressing GRAPH followed by any of 
the keys B K RQ PorN 








Exercises 






үе. Then if each 
he character set 


1. Imagine the space fot 
quarter can be either blac’ 


2 Runthis program. 


10 INPUT c 
20 PRINT CHRS c; 
30 GO TO 10 


tamh. find that CHR c is Tounded to the nearest whole number; and if € 1s 


1th the error report B integer out of 
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Part 15 
More about PRINT and INPUT 


Subjects covered... 


CLS 

PRINT items 

Expressions (numeric or string type) 
TAB numeric expression 
AT numeric expression 
PRINT separators, ; 
INPUT items 

Variables (numeric or string type) 
LINE string variable 

Scrolling 

SCREENS 


You have already seen PRINT used quite a lot, so you will have a rough idea of how it is used 
Expressions whose values are printed are called PRINT items. They may be separated by commas, 
semicolons or apostrophes, which are called PRINT separators. A PRINT item can also be 
nothing at all, which is a way of explaining what happens when you use PRINT onitsown, 


There are two more kinds of PRINT items, which are used to tell the +3 not what, but where to 
print. Forexample, the struction. 


10 PRINT АТ 11,16;"«" 


printsanasterix * m the centre of the screen. This is because. 


AT line , column 


moves the PRINT position (the place where the next item is to be printed) to the line and column 
specified. Lines are numbered from 0 (at the top) to 21; columns are numbered from 0 (on the left) to 
3l 


SCREENS is the reverse funchon to PRINT AT. and will (within limits) read! the character 
Which is located at a particular position on the screen. It uses lime and column numbers in the same 
wayasPRINT AT, butenclosed m brackets. For example, the instruction. 


20 PRINT AT 0,0; SCREENS (11,16) 


Will read the asterix printed in the centre of the screen. then Print it at location 0,0 (the top left-hano 
corner) 
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Characters from tokens are read normally (as single characters), and spaces are read as spaces. 
However, attempting to read user-defined characters, graphics characters, or linesdrawn by PLOT, 
DRAW and CIRCLE, result in a null (empty) string being returned. The same applies if OVER has 
been used to create a composite character (The keywords PLOT, DRAW, CIRCLE and OVER 
are described in parts 16 and 17 of this chapter.) 


You cannot normally PRINT or PLOT 


on the bottom two lines 
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The function... 


TAB column 


‚printa enough spaces to move the PRINT position to the column specified. It stays on the same 
ime, ог, if this would involve backspacing, moves to the next line Note that ће +3 reduces the 
column number modulo 32 (ie. t divides by 32 and takes the remainder)-so ТАВ. 33 means the 
sameasTAB 1 


Asanexample. 
PRINT TAB 30;1; TAB 12;"Contents 


M AT 3,1;"Chapter"; TAB 24;"Pag 
e" 


„ла how you might want to print out the headingon the contents page (page |) ofa book. 


Try running this, 


10 FOR п=0 TO 20 

20 PRINT TAB 8*n;n; 

30 NEXT n 
This shows whatis meant by the T AB numbers being reduced modulo 32, 
Fora more elegant example, change the 8 m line 20 to a 6. 
Note the following points. 


() TABs and prmt items are best terminated with semicolons, as we have done above, You can use 
commas (or nothing. at the end of the statement), but thts means that after having carefully set up the 
PRINT position, you immediately move it on again - not terribly useful! 


(и) You cannot print on the bottom two йпез (22 and 23) on the screen because they are reserved for 
commands, INPUT data, reports, error messages and so on. References to the bottomline’ usually 
mean line2] 


($) You can use АТ to locate the PRINT position even where there is already something printed 
*the new pnntitem will simply overwnte the old. 


Another statement connected with PRINT is CLS, Те clears the whole screen 


When printing reaches the bottorn of the screen, it starts to scroll upwards rather hke а tynewniter 
You can see this if you go into the small screen using the edit memi ороп Screen (described in 
chapter 6), and thentype... 


CLS: FOR n=1 TO 30: PRINT n: NEXT n 


When it has printed а screen fall the +3 will stop with the message s с го LL? atthe bottom of the 
Screen. You can now inspect Ihe first 22 numbers a! your léisire. When you have fished with them, 
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press Ү (for yes) and the +3 will give you the next screen full of numbers. Actually, any key will 
make the +3 carry on except М (for no), the BREAK key or the space bar. These will make 
the +3 stop running the program with the report D BREAK - CONT repeats. 


The INPUT statement can do much more than we have told you so far. You have already seen 
INPUT statements like... 


INPUT "How old are you?", age 


in which the +3 prints the capnon How old are you? at the bonom of the screen, and then 
you have to type in your age. In fact though. an INPUT statement can be made up of items and 
sepatators їп exactly the same way as a PRINT statement, so How old are you? and age 
are both INPUT items INPUT items are generally the same as PRINT stems, however. there 
are some very important differences. 


First, an obvious extra INPUT item ts the variable whose value you require to be typed in - age in 
ош example above. The rule is that ifan INPUT item beams with a letter, then И must be а variable 
whose value isto be input. 


This would seem to mean that you can’t pnnt our the values of variables as part of a caption. However, 
you can get round this by putting brackets around the variable. Any expression that starts with а letter 
must be enclosed in brackets if itis to be printed as part ofa caption 


Any kind of PRINT item that is not affected by these rules is also an INPUT item Here is an 
example to illustrate what's gomg on. 


LET my age = INT ( RND * 100): I 
NPUT ("I am ";my age;".");" How 
old are you?", your age 


my age ts contained in brackets, so its value gets printed out your age is not contained in 
brackets, so you have to type its value in. 


Everything that an INPUT statement writes goes to the bottom part of the screen, which acts 
somewhat independently of the top part In particular, its ines are numbered relative to the top line of 
the bottom half, even if this has moved up the actual TV screen (which it does if you type lots of 
INPUT data). Whatever the small screen does during INPUT, however. it will always rever! to 
being two lines in size when the program stops, and you start editing 


‘Tosee how AT worksin INPUT statements try this. 


10 INPUT "This is line 1.",a$; 
AT 0,0;"This is Line @.",а 
$; AT 2,0;"This is line 2." 
,а$%; AT 1,0;"This is still 
line 1.",a$ 


Ran the program (just press ENTER each time 1 stops). When This is line 2, is printed, the 
lower part of the screen moves up to make room for И, but the numbenng moves up as well, so that the 
Imesoftext keen their same numbers 


13 x 





Now try ths... 


10 FOR п=@ TO 19: PRINT AT n, Ø 
inz: NEXT n 

20 INPUT AT 0, 0;a$; AT 1, 0;aS 
р AT 2, 0;a$; AT 3, 0;а$; AT 
4, 8;a$; AT 5, 0;a$; 


As the lower part of the screen goes up and up, the upper part remams undisturbed until the lower 
part threatens to write on the same line as the PRINT position. Then the upper part starts scrolling 
"up toavoid this, 


Another refinement to the INPUT statement that we haven't seen yet is called LINE input and isa 
different way of inputting string variables If you use LINE before the name ofa string variable to bè 
input, asin., 


INPUT LINE a$ 


then ће +3 will not give you the string quotes that и normally does for a string vartable (though 1t 
will pretend to itself that they are there), So if youtype m 


bugs 


as the INPUT data, a$ will be смел the value bugs. Because the string quotes do пот appear 
with the string, you cannot delete them and type ine different sort of string expression for the INPUT 
data, Remember that you cannot use LI NE for numeric variables 


‘There's an interesting side effect to INPUT Whilst typing into ап INPUT request, the old 
Spectrum single-key entry system enjoys a brief moment of freedom before being locked away again 
when you press ENTER. Run this program if youre interested. 


10 INPUT numbers 
20 PRINT numbers 
30 GO TO 10 


Input à few numbers, and they'll be printed faithfully onto the screen. Now press EXTEND MODE 
followed by the M key. The word PI appears. and if you press ENTER, then 3. 1415927 will 
appear as if by mame However. if you type P I as two letters without the aid of EXTEND MODE then 
the +3 willstopwiththereport 2 Variable not found, 10:1 


There's io simple explanation for this behaviour, and it's best just to be aware that It can happen if you 
press some combinations of keys during INPUT If for some reason youre keen to experiment 
chapter 7 (їп 48 BASIC) will tell you which keys produce which effects 
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The control characters CHR$ 22 and CHRS$ 23 have effects rather like AT and TAB. Whenever 
the +dis instructed to print one of them, the character must be followed by two more characters that 
do not have their usual effect, but that are treated instead as numbers (their codes) to specify the line 
and column (for AT) от the tab position (for TAB). You will almost always find it easier to use AT and 
TAB in the usual way rather than use control characters, however, they might be usefull in some 
circumstances. The AT control character is CHR$ 22 The first character after it specifies the line 
number and the second specifies the column number, so that. 


PRINT CHR$ 22+ CHR$ 1+ CHRS c; 
» hasexactly the same effect as. 

PRINT AT 1, c; 
This is so that even if CHRS 1 or CHRS c would normally have a different meaning (for instance il 
£213) the CHR$ 22 before themoverndes that. 
The TAB control character is CHR$ 23 and the two characters after it combine to give a number 
between and 65538, specifying the number you would have ina T AB item. The statement.. 

PRINT CHRS 23+ CHRS a+ CHRS b; 
„ has the same effect as. 


PRINT TAB a*256*b; 
Youcanuse POKE tostop the computer asking if you wish to s c ro LL? by typing 


POKE 23692, 255 


“every so often After this it will scroll up 255 times Бейге stopping with s c rol? Asan example, 
пу 

10 FOR п=й TO 1000 

20 PRINT n: POKE 23692,255 

30 NEXT n 


and watch everything whizz off the screen! 
Exercise, 
|, Try this program on some children, to test their muitiplication tables. 


10 LET ms="" 

20 LET a= INT ( RND *12)*1: LE 
T b = INT ( RND *12)*1 

30 INPUT (m$) ' ' "what is ";( 
ade" x ";(b);"?";c 

100 IF с=а*Ь THEN LET m$="Right 
.": 60 TO 20 

110 LET m$="Wrong. Try again.": 
60 TO 30 





118 





If they are perceptive, they might manage to work out that they do not have to do the calculation 
themselves. For instance, if the +3 asks them to type the answer to 2 x 3, then all they have to do is 
type in 2*3 literal.y. 
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Part 16 
Colours 


Subjects covered... 


INK, PAPER, FLASH, BRIGHT, INVERSE, OVER 


BORDER 


Run this program 


10 FOR т=0 TO 1: BRIGHT m 

20 FOR n=1 TO 10 

3@ FOR с=0 TO 7 

4@ PAPER c: PRINT " ng 
4 coloured spaces 

50 NEXT c: NEXT n: NEXT m 

60 FOR m-0 TO 1: BRIGHT m: 
ER 7 

70 FOR с=0 TO 3 

80 INK c: PRINT c;" "; 

90 NEXT c: PAPER Ø 

100 FOR c=4 TO 7 

118. TNK-es PRENT cat ""s 

120 NEXT c: NEXT m 


REM 


PAP 


130 PAPER 7: INK Ø: BRIGHT Ø 






This shows the eight ding white an 
cat; produce on a colour ТУ “(if your TV is blar 
теу.) A quicker way to achieve a similar result x 
but that'sa little drastic Here sa listo 





Q- black 

l- blue 
2-red 

3- magenta 
en 
§-cyan 
6-yellow 
T. white 











chnumt hers produce Which 


and the two levels of bnghtness that the +3 


then you will see just various shades of 
ne +3 whilst holding down BREAK 
rs (for your reference), 





On a black-and-white TV. these numbers are in order of bnghiness То use these colours properly, 
you need to understand а bit about how the picture isarranged. 
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The picture is divided up into 768 (24 lines of 32) positions (cells) where characters can be printed. 





Atypical character cell 


Each character cell consists of an 8 x 8 gnd (such as above). This should remind you of the 
user-defined graphics in part 14, where we had Os for the white dots and 1з for the black dots. 


The character has two colours associated with it the ink, or foreground colour, which is the colour for 
the black dots in our square, and the paper, or background colour, which is used for the white dots. To 
start off with, every cell has black ink and white paper so writing appearsas black on white. 


The character also has a brightness (normal or extra bright), and something to say whether it flashes 
or not, Flashing is done by continuously swapping the ink and paper colours. АП this information can 
be coded into numbers, зо а character then has the following. 

(i)  An8x8gndof0sand Isto define the shape of the character, with 0 for paperand ! forink. 

(ü)  Inkand paper colours, each coded intoa number between Qand 7 

(ш) Abnightness-0 for normal, | for extra bnght 

(v)  Afashnumber -Oforsteady, 1 for flashing. 

Note that since the ink and paper colours cover a whole character cell. you cannot possibly have more 
than two colours m a туеп block of 64 dots. The same goes for the brightness and flash numbers - they 


refer (о the whole character cell, not individual dots within ће cell. The colour, brightness and flash 
number fora уеп character celi are called attributes. 





118 





"When you print something on the screen, you change the dot pattern for that character cell. It is less 
obvious, but still true, that you also change the cell's attributes. To start ой with you do not notice this 
because everything is printed with black ink on white paper (at normal brightness and no flashing); 
however, you can vary this with the INK, PAPER, BRIGHT and FLASH statements. Using the 
edit menu's S c r een option, go to the bottom screen, and try.. 


PAPER 5 


„and then PRINT a few tems on the screen - they will appear on cyan paper, because as they are 
printed, the paper colour for the cells they occupy are set to cyan (which has code 5) 


The others work the same way, so you may use the settings... 


PAPER (whole number between Qand 7) 
INK (whole number between 0 and 7) 
BRIGHT (whole number between бапа 1) 
FLASH (whole number between 0 and 1) 


.and any printing will set the corresponding attributes for all the character cells it subsequently uses. 


Try some of these out. You should now be able to see how the program at the beginning of this section 
worked (remember that a space isa character that has its ink and paper the same colour). 


‘There are some more numbers you can use in these statements that have less direct effects, 


B can be used in all four statements, and means transparent in the same sense that the old attribute 
shows through. Suppose, for instance, that you do 


PAPER 8 


Мо character position will ever have its paper colour set to 8 because there is no such colour; what 
happens is that when a positon is printed on, its paper colour is left the same as it was before, 
However, INK 8, BRIGHT 8 and FLASH 8 work the same way as for the other attribute 
numbers. 


9 сап be used only with PAPER and INK, and means ‘contrast The colour (ink or paper) that уо 
use it with ismade to contrast with the other by being made white if the other isa dark colour (black, 
blue, red or magenta), or being made black if the other tsa light colour (green. суап, yellow or white). 


Try thas by дота, 
INK 9: FOR с=@ TO 7: PAPER c: PRINT c: NEXT c 


A more impressive display of its power is to run the program at the beginning to make coloured 
stripes (again, making sure that youare m the lower screen when you type RUN), and then doing. 


INK 9: PAPER 8: PRINT AT Й, 0; : 
FOR n=1 TO 1000: PRINT n;: NEXT n 


The ink colour heres always made to contrast with the old paper colour for each character cell. 
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Colour TV relies on the fact that the human eye need see only three colours of light (red, green and 
blue) in various combinations and mtensities in order to perceive all the colours of the spectrum The 
+3 also displays its spectrum of colours by usmg mixtures of red. green and blue. For instance, 
yellow is made by mixina red with green - which is why its code, б. is the sum of the codes for red and 
green 


To see how all eight colours fit together. imagine three rectangular spotlights, coloured red, green 
and blue shining at not quite the same place ona piece of white paper in the dark. Where they overlap 
you will see mixtures of colours, as shown by the following program (note that solid mk spaces are 
obtained by entering graphics mode (pressing GRAPH) then holding down CAPS SHIFT while 
pressing 6. To exit from graphics mode, press9. 


10 BORDER Ø: PAPER Ø: INK 7: С 
LS 
20 FOR а=1 TO 6 
30 PRINT TAB 6; INK 1; MENHHEEN 
Was": REM 18 ink sq 
uares 
40 NEXT a 
50 LET dataline=200 
60 GO SUB 1000 
70 LET dataline=210 
80 GO SUB 1000 
90 STOP 
200 DATA 2,3,7,5,4 
210 DATA 2,2,6,4,4 
1000 FOR a-1 TO 6 
1010 RESTORE dataline 
1020 FOR b=1 TO 5 
1030 READ c: PRINT INK c;" MEN 
"ss REM 6 ink squares 
1040 NEXT b: PRINT: NEXT a 
1050 RETURN 








There isa function called AT TR that finds out what rhe attnbutes are at à given position on thescreen 
Itisa farrly complicated function, so it has been relegated to the end of this section 


There ате two more statements INVERSE and OVER which control not the attributes; but the dot 
pattern that 15 printed on the screen for off and 1 for on. If you us 
INVERSE 1. then each charac rse of its usual form, ie. paper 
dots will be replaced by mk dots and vice versa. Thus the character cell containing ‘a’ (shown 
previousiy) would be printed as follows (on the next page). 
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f (as а! switch on) we have black ink and white paper. then the 'a' willappear as white on black 








ten int haracter 
7 OVER 1, the new 
particular ul for wnting composite 
puter and select 


+3 BASIC. Note that the underline charact ї i by pr 3 SYMB SHIFT together with 
a 





haracter 1s simply ad 





10 OVER 1 
20 PRINT "y"; CHR$ 8;" "; 





V е used the ser CHRS B (backs prnung the w 
INK.PAPER whi 














PAPER, INK, etc. when used as statements do not affect the colour in the bottom part of the screen 
(where INPUT data1s typed in and reportsare displayed). The bottom screen uses the colour of the 
border for its paper colour, code 9 (for contrast) for its mk colour, has flashing off, and everything at 
normal brightness. You can change the border colour to any of the eight normal colours (not 8 or 8) 
using the statement.. 


BORDER colour 


When you type m INPUT data, it follows this гше of using contrasting ink on border coloured paper; 
but you can change the colour of the captions written by ће +3 by using PAPER, INK, etc items 
inthe INPUT statement, just as you would in a PRINT statement Their effect lasts either to the end 
ofthe statement, or untilsome I NPUT data is typed in, whichever comes soonest Try 


INPUT FLASH 1; INK 4;"Enter a number?";n 
The +3 has a high regard for your sanity - no matter what combmation of effects and colours you 
manage to produce froma BASIC program, the editor will always use black ink on white paper. 
There ts one more way of changing the colours by using control characters - rather like the control 
characters for AT and ТАВ in part 18 


CHRS 16 correspondsto INK 
CHR$ 17 correspondsto PAPER 
CHR$ 18 correspondstó FLASH 
CHR$ 19 correspondsto BRIGHT 
CHR$ 20 сопеѕропізіо INVERSE 
CHR$ 21 correspondsto OVER 


These are each followed by one character that shows a colour by its code, so that (for instance). 
PRINT CHRS 16+ CHRS 9;"item" 


has the same effect as. 
PRINT INK 9;"item" 


‘On the whole; you would not bother to use these control characters because you might just as well use 
the statements PAPER, INK, etc. However, if you have some old 48K BASIC programs on cassette, 
you may find such contro! characters embedded in the listing. In general, the editor will actively 
ignore them. and remove them at the first opportunity. It is not possible to insert them into listings as 
withthe old 48K Spectrum: 


The AT TR function hasthe form 
ATTR Cine column) 





Its two arquments ате the line and column numbers that you would use inan AT tem. anditsresultisa 
number that shows the colours and so on al the corresponding character positon on the TV screen: 
Youcan use thisas freely in expressions as you can any other function: 


The number that isthe resultis the sum of four other numbets аз follows. 


128 ifthe character cell is flashing. Oif itis steady. 
64 Ме character cell is bughi. Ovfitis normal 
8 multiplied by the code for ће paper colour 
1 multiplied by the code for the nx colour 


Furinstance: if the character cell is flashing. normal brightness, yellow paper and blue ink then the 
four numbers that we have to add together are 128 0, 8x6=48 and | making 177 altogether Test tins. 
with 


PRINT AT 0,0; FLASH 1; PAPER 6; 
INK 1;" "; ATTR (0,0) 


Exercises 
L my. 
PRINT "B"; CHR$ 8; OVER 1;"/"; 


Where the / has cut through the B. it has left a white dot. This is the way that overprinting works on 
the +3 -two papers or two Inks give а paper one of each civ This has the interesting 
property thar if with the same thing twice you end up wath what уои had at the 
beginning H you ne 











PRINT CHRS 8; OVER 1; 


why do Yui ram biemisied B 





* Punthis procrem 


10 POKE 22527+ RND *704, RND * 
127 
20 GO TO 10 










clours of squares on the TV 
ial stt] that you 
iom istead of truly 


es ) The program ts chanain 
that ndomiy (The dia 
ot the hiddez ра RND е pseudo- 
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Part 17 
Graphics 


Subjects covered... 


PLOT, DRAW, CIRCLE 

Pixels 
For all of this sechon, type in the example programs, commands and RUN in the small screen (use the 
edit menu's $ c re en option) 
In this section we shall see how to draw picturesonthe +3. The part of the screen you can use has 22 
lines and 32 columns, making 22x32=704 character positions. As you may remember from part 16, 
each of these character positions is made up of an 8 x 8 grid of dots which are called pixels (picture 
elements). 
A pixel is specified by two numbers - its coordinates. The first, its x coordinate, says how far it is across 
from the extreme left-hand column. The second, its y coordinate, says how far it is up from the bottom. 
These coordinates are usually written asa pair m brackets, so (0,0) (225,0) (0,175) and (285, 178) are the 
bottom left, bottorn right, top left and top right corners of the screen. 
If you have trouble memorising which coordinate is which, simply remember that x is a cross (x is 
across), 


The statement 
PLOT xcoordinate , y coordinate 
inks in the pixel with these coordinates, so this measles program. 
10 PLOT INT ( RND *256), INT € 


RND *176): INPUT a$: GO TO 
18 


plotsa random point each time you press ENTER. 
Here isa rather more interesting program. It plots a graph of the function S I М (a sine wave) for values 
between Qand 2л. 


10 FOR п=0 TO 255 

20 PLOT n, 88*80* SIN (n/128* 
PI ) 

30 NEXT n 


Thisnext program plotsa graph of S QR (part ofa parabola) between 0 and 4 


18 FOR n=B TO 255 
20 PLOT n, 80% SQR (n/64) 
30 NEXT n 


124 





Notice that pixel coordinates are rather different from the line and column inan AT item. You may find 
that the diagram in part 15 of this chapter is useful when working out pixel coordinates and line and 
column numbers. 


To help you with your pictures, the +3 will draw straight lines, circles and parts of circles for you, 
using the DRAW and CIRCLE statements. 


The statement DRAW (to drawa straight line) takes the form. 


DRAW x,y 


The starting place of the line is the pixel where the last PLOT, DRAW or CIRCLE statement left off 
(this 1s called the PLOT position - RUN, CLEAR, CLS and МЕМ reset it (о the bottom left-hand 
comer, at 0,0), the finishing place of the line ts x pixels to the right of that and y pixels up. The DRAW 
statement on itsown determines the length and direction of the line, but not its starting point. 


Expenment witha few PLOT and DRAW commands, for instance 


PLOT 0,100: DRAW 80,-35 
PLOT 90,150: DRAW 80,-35 


Notice that the numbers in а D RAW statement can be negative, bul those 1 à P LO T statement can't. 


You can also plot and draw їп colour, although you have to bear in mind that colours always cover the 
whole of a character cell and cannot be specified for individual pixels. When a pixel is plotted, it is set 
to show the full mk colour, and the whole of the character cell containing it is given the current ink 
colour. This program demonstrates that point. 


10 BORDER Ø: PAPER 0: INK 7: С 
LS: REM black out screen 

20 LET х1=@: LET у1=0: REM sta 
rt of Line 

30 LET c=1: REM for ink colour 
» Starting blue 

40 LET x2= INT ( RND *256): LE 
T y2= INT ( RND *176): REM 
random finish on Line 

50 DRAW INK c;x2-x1,y2-y1 

60 LET x1-x2: LET yl=y2: REM n 
ext Line starts where last 
one finished 

70 LET с=с+1: IF c-8 THEN LET 
c=1: REM new colour 

80 GO TO 48 








‘The lines seem to get broader as the program goes on, and this is because a line changes the colours 
of all the inked-n pixels of all the character cells that it passes through. Note that you can embed 
PAPER, INK, FLASH, BRIGHT, INVERSE and OVER items in a PLOT or DRAW 
statement just as you could with PRINT and INPUT. They go between the keyword and the 
coordinates, and are terminated by either semicolons or commas. 


An extra frill with DRAW is that you can use it to draw parts of circles instead of straight lines, by 
including an extra number to specify an angle to be turned through. The formis... 


DRAW х,у,а 
хала y are used to specify the finishing point of the line just as before, and a is the number of radians that it 
must turn through as it goes, If a is positive then 1t turns to the left, if а is negative then it turns to the right. 


Another way of seeing а is as showing the fraction of a complete circle that will be drawn, (a complete circle 
1527 radians) so а equals 7 it will draw a semicircle, fa equals 0.Sxma quarter of a circle, and so on. 


For instance, suppose a equals т. Then whatever values x and y take, a semicircle will be drawn: 
Try, 


10 PLOT 100,100: DRAW 58,50, РІ 


which will draw this. 


Finish at (160,150) 


Start at (100,100) 


The drawing starts off m a south-easterly direchon, but by the time it stops. 11 is going north-west. In 
between, it has turned through 180 degrees, or т radians (the value of a) 


Run the program several times, with PI replaced by vanous other expressions eg - PI, PI/2 
3*Р1/2.Р1/4.1,@ ес. 


The last statement in this section 15 CIRCLE which draws ап entre circle. You specify the 
coordinates of the centre and the radius of the circle using 


CIRCLExcoorüinate , y coordinate , radius 
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Just аз with PLOT and DRAW, you can put the various sorts of colour items in at the beginning of a 
CIRCLE statement 


The POINT function tells you whether a pixel is ink or paper colour Its two arguments are the 
coordinates of the pixel (which must be enclosed in brackets) and its result is 0 if the pixel is paper 
colour, or 1 ifitisink colour Try, 


CLS : PRINT POINT (0,0): PLOT Ø, 
@: PRINT POINT (0,0) 


Type 
PAPER 7: INK @ 


and investigate how INVERSE and OVER work inside a P LOT statement. These two affect just 
the relevant pixel, and not the rest of the character cell, They are normally off (0) in a PLOT 
statement, so you only need to mention them to turn them on (1), 


Heressa listof the possibilines for reference 


PLOT; = This ts the usual form. It plots an ink dot, ie; sets the 
pixel to show the nk colour. 

PLOT INVERSE 1; Thisplotsa dot of ink eracicator, ie. ttsets the pixel to 
show the paper colour. 

PLOT OVER 1; * This exchanges the pixel colour with whatever it was 


before. so if it was ink colour then it becomes paper 
colour, and vice versa 


PLOT INVERSE 1; OVER 1; -This leaves ће pixel exactly asit Was before, but note 
that it also changes the P LOT position, so you might 
use itsimply todo that 


Asanother example of using the OVER statement, fill the screen up with writing using black on white, 
and then type 


PLOT 0,0: DRAW OVER 1;255,175 


This will draw a fairly decent line, even though it has gaps in it wherever it hits some writing. Now type 
in exactly the same command again. The line wil vanish without leaving any trace whatsoever - (his 1s 
the greatadvantageofOVER 1 Ifyouhad drawn the hne using. 
PLOT 0,0: DRAW 255,175 
and erased it using. 
PLOT 0,0: DRAW INVERSE 1;255,175 
then you would also have erased some of the wnting. 
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Now try.. 
PLOT 0,0: DRAW OVER 1;250,175 
„and try to ‘undraw it using... 

DRAW OVER 1;-250,-175 
This doesn't quite work because the pixels that the line uses on the way back are not quite the same as 
PIS раа Аар You must therefore undraw a line in exactly the same direction 


One way to get unusual colours is to speckle two normal ones together in a single square, using à 
user-defined graphic. Try this program. 


1000 FOR п=@ TO 6 STEP 2 

1010 POKE USR "a"*n, BIN 0101010 
1: POKE USR "a"*n*1, BIN 10 
1010180 

1020 NEXT n 

1030 REM now press GRAPH then A 


which gives the user-defined graphic corresponding to a chessboard pattern. If you print this 
character (press GRAPH, then A) you will find that the character is reproduced in à combination of 
the current paper and ink colours. 


Exercises. 


1, Expenment with PAPER, INK, FLASH and BRIGHT items ina PLOT statement. These are 
the parts that affect the whole of the character cell containing the pixel. Normally it 15 as though ће 
PLOT statement had started oft 


PLOT PAPER 8; FLASH 8; BRIGHT 8; ес 


„and only the ink colour oí a character cell is altered when something 15 plotted there, but you can 
change this if you wish. 


Be especially careful when using colours with INVERSE 1, because this sets the pixel to show the 
paper colour, and may change theink colour, which might not be what you expect 


2. If you have read part 10, see if you can work out how to draw carclesusing S IN and COS. Run this 
program. 


10 FOR n=@ TO 2* PI STEP PI /1 
80 

20 PLOT 100+80* COS n, 87*80* 
SIN n 

30 NEXT n 

40 CIRCLE 150, 87, 80 


Youcanseethatthe CIRC LE statement is much quicker albeit lessaccurate. 
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————————————————O 
3. Try. 


CIRCLE 100,87,80: DRAW 50,50 


You can see from this that the CIRCLE statement leaves the PLOT position at a rather 
indeterminate place - it 1s always somewhere about half way up the right-hand side of the circle, You 
will usually need to follow the CIRCLE statement with a PLOT statement before you do any more 
drawing. 








Part 18 
Timing 
Subjects covered... 


PAUSE, PEEK, INKEYS 


Quite often you will want to make the program take a specified length of time, and for this you will find 
the PAUSE statementuseful 


PAUSE п 


(stops computing ала displays the picture for n frames of the TV (there ere 50 frames per second in 
Europe and 60 in USA). The value of п can be up to 65535, which gives you a pause of just under 22 
minutes. Ifn=0 then it means pause indefinitely’ 


A pause canalways be cut short by pressing a key. 
Thisprogram works the second hant ofa clock 


10 REM first we draw the clock 
face 
20 FOR n=1 TO 12 
30 PRINT AT 10-10* COS (n/6* P 
I ),16+10* SIN (n/ó* PI );n 
40 NEXT n 
50 REM now we start the clock 
60 FOR t-Ü TO 200000: REM t is 
the time in seconds 
70 LET a-t/30* PI : REM а is t 
he angle of the second hand 
in radians 
80 LET sx=80* SIN a: LET sy=80 
* COS a 
200 PLOT 128,88: DRAW OVER 1;sx 
4,Sy: REM draw second hand 
210 PAUSE 42 
220 PLOT 128,88: DRAW OVER 1;sx 
‚зу: REM erase second hand 
400 NEXT t 


The clock will run down after abou! hours because of bne 80, but you can easily make it тш 
longer. Note how the timmg is controlled by line 210. You might expect PAUSE 50 to make it псе 
once per second, however, the computing takesa bit of timeas well and has to be allowed for. This is 
best done by trial and error, timing the +3 clock againsta real one, and adjusting line 210 until they, 
agree Youcan'tdo this very accurately -an adjustment of one frame per second 1s equal to 2% (or half 
anhourma day). 
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——————————————————————————————e 
There is à much more accurate way of measuring time. This uses the contents of certain memory 
locations. The data stored is remeved by usmg PEEK. Part 25 of this chapter explains whal we're 
looking atin detail. Type in the expression. 


PRINT (65536% PEEK 23674+256* PE 
EK 23673+ PEEK 23672) /509 


‘This рпі the number of seconds since the +3 was turnedon (up to about 3daysand 21 hours after 
which it goes hack tod) 


Here isa revised clock program to make use of this. 


10 REM first we draw the clock 
face 

20 FOR n=1 TO 12 

30 PRINT AT 10-10* COS (n/6* Р 
I ),16*10* SIN (n/6* PI );п 

40 NEXT n 

50 DEF FN t()= INT ((65536* PE 
EK 23674*256* PEEK 23673+ P 
ЕЕК 23672)/50): REM number 
of seconds since start 

100 REM now we start the clock 

110 LET t1= FN tC) 

120 LET a=t1/30* PI: REM a is t 
he angle of the second hand 
in radians 

130 LET sx-72* SIN a: LET sy=72 
* COS a 

140 PLOT 131,91: DRAW OVER 1;sx 
„зу: REM draw hand 

200 LET t= FN tO 

210 IF t<=t1 THEN GO TO 200: RE 
M will wait until time for 
next hand 

220 PLOT 131,91: DRAW OVER 1;sx 
Sy: REM rub out old hand 

230 LET t1-t: GO TO 120 





The internal clock that thts method uses should be accurate to about 0.01% (approx 10 seconds per 
day)solongasthe +3 issimply running the program. However, when you use ће BEEP statement 
(described m part 19 of this chapter) or operate the disk drive or any peripheral -ttached to the +3 
(eg. apunteror second disk drive), the mternal clock stopstemporarily, losing time. 
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The numbers PEEK 23674. PEEK 23673 and PEEK 23672 are held inside the +_ 
3 and used for commting in 50ths of a second. Each is between 0 and 255 and they gradually increase 
through all the numbers from 0 to 255, after 255 they drop straight back to 0. 


‘The one that mcreases most often is PEEK 23672 -every 1/50 secondit increases by 1. When itis 
at 286, the next increase nudges it to 0, and at the same time it increments PEEK 23673 up by 1 
When (every 256/50 seconds) PEEK 23673 = nudged from 255 to 0, it in turn increments 
PEEK 23674 upby L Thisshould be enough to explain why the expression above Works. 


‘Now, consider this carefully: suppose our three numbers ате 0 (for PEEK 23674), 255 (for PEEK 
23673) and 255 (for PEEK 23672) This means that it is abour 2] munutes afer switch on Our 
expression ought to yield (6583630 256x258 255)/S0 which ts equal to 1310.7 


But there 1s a hidden danger - the next time there is a 1/50 second count, the three numbers will 
change to I, 0 апа 0. Every so often, this will happen when you are half way through evaluating the 
expression - the +3 would evaluate PEEK 23674 as0, but then change the other two to 0 before 
1t can PEEK them. The answer would then be (65536х0+256х0+0)50 which 15 equal to 0, which is 
obviously wrong. 

A simple way of avoiding this problem is to evaluate the expression twice in succession and take the 
larger answer 


Now if you look carefully at the previous program. you can see that it does this implicitly, 
Here isa trick lo apply the гше Define the functions. 


10 DEF FN m(x,y)=(xt+y+ ABS (x- 
y))/2: REM the Larger of x 
and y 

20 DEF FN u()=(65536* PEEK 236 
74*256* PEEK 23673+ PEEK 23 
672)/50: REM time (may be м 
rong) 

30 DEF FN t()= FN mC FN uC), F 
N u()): REM time (correct) 


You can change the three counter numbers so that they суе the real time instead of the time since the 
+3 was switched on. For instance, to set the time at 10 00am, you work out that this ıs 10 x 60x 60 x $0 
which is equal to 1800000 fiftieths ofa second (and 1800000 1s equal to 65536 x 27 + 256 x 119 + 64 x 1). 


Tosetthe three numbersto 27 118 20 64 youtype 
POKE 23674,27: POKE 23673,119: POKE 23672,64 


In countries with mains frequencies of 60 Hz (cycles per second), these programs must replace 50 by 
60 where appropriate 
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The function INKEY$ (which has no argument) reads the keyboard If you are pressing just one key, 
(or say, CAPS SHIFT and just one other key), then the result is the character which that key gives 
normally, otherwise the result isan empty string. 


Try this program, which works like a typewnter. 


10 IF ІМКЕҮ$ <> "" THEN GO TO 
10 

20 IF INKEYS " THEN GO TO 20 

30 PRINT INKEYS ; 

40 60 TO 10 


Here line 10 waits for you to lift your finger off the key board: and line 20 waits for you to press a new 
key. 





Unlike INPUT, ІМКЕҮ$ doesn't watt for you, so you don't have to press ENTER. 


Exercises. 

1. Whathappensif you miss out line {0 inthe typewnter program? 

2. Another way of usina INKEYS 15 in conjunction with PAUSE as in this alternative typewriter 
program. 


10 PAUSE @ 
20 PRINT INKEYS ; 
30 GO TO 10 


To make this work, why isit essential that а pause should not finish if it finds you already pressing a key 
whenit starts? 


3 Adapt the 












Part 19 
Sound 


Subjects covered... 
BEEP,PLAY 


As you will have already noticed, the +3 can make a vanety of noises. To get the best quality of 
sound, It's important to make sure that your ТУ ss tuned-in properly (see chapter 2). If instead of a TV. 
you are using a VDU monitor (which won't reproduce ће +3’s sound), note thal a separate sound 
signal (Which may be connected to ап audio amplifier powering speaker(s) or headphones) Is 
available from the TAPE/SOUND socket at the back the +3 Headphones may not be plugged into 
the TAPE/SOUND socket directly 


Connections to the TAPE/SOUND socket are described m chapter [0 
To get the most outofthe +3's musical ability, it helpsto havea little knowledge about musical terms 


Nole that in the examples that follow, it is important that you type in the string expressions exactly as 
shown in upper case and lower case letters. 1e the example "да" should not be typedinas "ба" 
"oA" or "GAN 

gA"or"GA 


‘Type in thiscommand (don't worry about what it means just yet) 


PLAY "ga" 


‘Two notes ware played - the second slightly higher than the first. The difference between the notes is 
calleda tone, Now try. 


PLAY "g$a" 


Again there were two notes played -the first one was the same as the previous example. but there wes 
Jess of a jump to the second. If you didn't hear the difference: then try the first example followed by the 
second again, The second example has half the difference between notes and this 15 called а 
semitone 


When you re happy with semitones. try this 


PLAY "gD" 


‘This sort of difference ts called a fifth and occurs quite often in music of all lands: With that example 
ringing im your ears, type. 


PLAY "дб" 
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Although (hopefully) you noticed that there was a much bigger difference that time than for the fifth, 
the two notes somehow sounded much more similar. This is called an octave, and is the point at which 
music starts to repeatitself Don't worry about that unduly, just remember what an octave sounds like 


There ate two ways of making music and sounds with the +3 The most elementary is the somewhat 
spartan BEEP command This takes the form 


ВЕЕР duration, pitch 


where the duration and pitch parameters represent numerical expressions. The duration is given m 
seconds, and the pitch is given in semitones above middle C (negative numbers for notes below 
middle C) 


Hereisa diagram to show the pitch values of all the notes one octave on the piano for BE EP. 





Hence. to play the A above middle C for halfa second. you would use. 


ВЕЕР @.5,9 


and to play a scale (for example. C major) а complete (alber short) program is needed 


10 FOR f=1 TO 8 

20 READ note 

30 ВЕЕР 0.5,note 

40 NEXT f 

50 DATA 0,2,4,5,7,9,11,12 


То get higher or lower notes you have to ada or subtract 12 foreach octave that you go up ot dów. 


BEEP exists mostly to provide compatibil 
useful for very short or rapid зош 


nth the older designs of Spectrum, though it can be 
programs you develop, the second way of 
rred, and d this 15 achieved using the PLAY command (if you 
wer in this section. you'll remember that that's what you 
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PLAY ismuch more flexible than ВЕЕР - it can play up to three voices m harmony with all manner of 
effects, and gives = much higher quality of sound It's also much easier to use. For example, to play A 
above-middie C for half a second. simply type m... 


PLAY "a" 


„and to play ће C major scale (which needed a program to itself before), use. 
PLAY "cdefgabC" 


Notice that the läst С in the example above тє in upper case. This tells the P LA Y command to play it 
an octave higher than the lower case € A scale. by the way is the term used for a set of notes 
spanning an octave. The example above ts called the C major scale because it's the set of notes 
between two Cs. Why major? There are two main classes of scale. major and minor, and this 1s just 
musical shorthand for describing two different sets Just for interest, the C minor scale sounds like 
this.. 


PLAY "cd$efg$a$bC" 


Preceding a note by $ drops it by a senmone (flattens 1t), and preceding а note by # raises it by а 
semitone (sharpens it) The PLAY command spans 9 octaves. and can be told which one to use by 
having the upper case letter 0 followed by à number, m the list of notes it is given. Type m this little 
program 


10 LET o$="05" 
20 LET n$="DECcg" 
30 LET а$=о$+п$ 
40 PLAY a$ 


There are a few new things in thts program Firstly, PLAY is just as happy with a string variable as 
with а string constant. In other words. providing that a$ has been set up beforehand, PLAY a$ 
works Just as well as PLAY "OSDECcg" In fact. using vanables in PLAY statements has 
certain distinct advantages and we shal) be doma this from now on. 


Notice also that the string a$ has been bunt up by combining the two smaller strings 0$ and n$ 
While this doesn’t make much difference at this sort of level PLAY can cope with strings many 
thousands of notes long. and the only sensible way of creating and editing those strings from BASIC 1s 
tocombine lotsofsmallet strmas m this way 


Now run the above progrant Edit line 10 so that "05" becomes "07" and rani it agam, or if you 
want to Беа big spaceship make it "02". If you доп! specify an octave number for a patticular 
string, then'the +3 assumes that you want octave 3 Here follows a diacram of the notes and octave 
numbers which correspond to the standard even-tempered musicalscale 





136 



























































There isa lot of overlap. so for example, "030" isthe same as "04d" This makes if easier to write 
tunes without having to change octave all the time. Some of the notes 1n the lowest octaves (0 and 1) 
aren't very accurate for techmcal reasons. and so the computer just makes a brave attempt at getting 
asclose as possible. 











PLAY canalso handle many different lenaths of note. Edit the program above so that line 1015 now 


10 LET o$="2" 


and tumit Then alter the setting of 0$ between " 1" and "9" The note length can be changed 
anywhere m а string by including a number between | and 9 and this 1s effective for all subsequent 
notes until a new number ts encountered. Each of these nine note lengths hasa specific musical name. 
and looks different when written down in musical notation. The following table shows which is which 
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triplet semi-quaver 
triplet quaver 


triplet crotchet 





10 LET o$="04" 
20 LET n$z"DEC&cg" 











seems в qood bet- but 20 The computer will find the 0 and try to read the number following it 
When it finds 62. it will stop with the report п Out of range In cases like this there is à 
dummy note called М that just serves to split things up, so. 10 поша be 





10 LET o$="06N2" 


The volume can be set between О (minimum) and 15 (maximum) using " V^ followed by anumben In 
practee only 1010 15 are likely to be useful. as 110 Sare toosoftuntessthe +3 is beingused withan 
amplifier As previously mentioned. ВЕЕР is louder than a smale channel of PLAY but if all three 
channels play a noteat volume 15, then и should be at the same level asa note produced by BEEP. 











Playing more than one cham 
this new program 


10 LET a$-"O4cCcCgGgG" 
20 LET b$-"O6CaCeSbdSbD" 
30 PLAY a$,b$ 


ta hime i$ Very simple, you just separate lists о! notes by commas Try 






In general. there is no difference between the three channels. and any stnng of notes can be put onto 
any channel. The overall speed cf the music (the tempo) mast bean the string assigned to channel A 
(the frst string after PLAY), othervase it will be ignored. To set tempo in beats (crotchets) per 











mmute, use "Т" fofi 
crotchets persecond. Mi a prooráriabove to 


5. LET t T1290" 

10 LET a$-t$*"04cCcCgGgG" 
20 LET b$-"OQóCaCeSbd$bD" 
30 PLAY a$,bS 


ind run itseveral times. changing line 5 for different tempos. 


jer between 60 and 240 The standard value is 120. or two 











A common feature m musicis the repetition д! 
enclosing it in brackets 


aroup of notes Any рап! с!а пла can be repeated by 
wif you change ane 10! 


10 LET aS=t$+"04(cC)(gG)" 


PLAY treats |] just ће same as the did line 
ming bracket) then the sinng up 19 that po 
uden: 












Вуса ir е а closing bracket (with no matching 
t is repeated indefinitely This 1s ui for rhythm 
nstrate try this {you 1 have to press BREAK tostor the sound) 









PLAY "O4N2cdefgfed)" 


PLAY "O4N2cd(efgf)ed)" 
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Ifyou set up an infinitely repeating bass line, and then play a melody withit, then 1t would be nice ifthe 
bass line stops when the melody does. There is a device to do this - if PLAY comesacross "Н" (for 
halt) in any of the strings itis playing, then її stops all sound immediately. Run the following program 
(again, you'll have to press BREAK to stop it) 


10 LET aS$-"cegbdfaC" 
20 LET b$-"O4cC)" 
30 PLAY a$,b$ 


Now modify hine 1010; 


10 LET a$- 
and run it agam. 








cegbdfaCH" 


So far we've only used notes which start and stop at one level of volume. The +3 can alter the volume 
of a note while if 1s playing, so it can start loud and dre away like a piano, or nse and fall like а dog 
growling, To turn these effects on, use "М" (for waveform) followed by a number between 0 and 7, 
together with "U" for each channe) you want to use the effect on. Any channel with a volume setting 
("V") will not respond to "U" This table shows graphically how the volume changes for each 
setting 


I n O-single decay then off 
2; «single attack then off. 


ji 2-single decay then hid 
34. — — — . 3. sngie attack then bold 
4 4-repeateddecay 
AUN -  B-repeatedattack 
AAA 5- repeated attack-decay 
5 1- repeated decay attack 





This programı plays the same note with each effect in turn. so you сап compare them асат {һе 


diagram above 


10 LET a$-"UX180QUWÜCRWTCRW2CRMW 
SCRWACRWSCRWÓCRW7C" 
20 PLAY a$ 











SS 


The U turns on effects, and the W selects which waveform to use. There'salsoan"X1000", X sets 
how long the effect will last for (from 0 to 65535). If you don't mclude an X, thenthe +3 will choose the 
Jangest value. Waveforms that settle down (0 to 31n the previous table) after the mitral part, work best 
with X settings of about 1000, whereas repetitive effects (4-7) are more effective with short values like 
300), Try varying the X setting in the previous program to get some Kiea of how each works. 


The PLAY command isn't limited to pure musica! notes There are also three ‘white nose’ generators 
(white noise 1з а sound which ts like an un-tuned FM radio or TV). and any of the three channels сап 
play notes, white noise, or a mixture of both To select a myx of noise and note. you may use "M" 
followed by a number between | and63. Youcan work out which number to use from this table. 





White down the numbers corresponding 10 the effects you want, and then add them together, If you 
wanted Ato be noise. Bto be tone. and Cto be both tone and nose thenadd 8, 2, 4 and 32 to get 46 (the 
order of the channels is the order of the strinas which follow the PLAY command). The best effects 
can be obtained with the A channel - don't be afraid to experiment 





By now, you'll be wnting symphonies: However, it can be difficult to work out just which part'of the 
music а parncular section of string ts responsible for. To alleviate this problem, your music string тау. 
include ‘comments enclosed between ! exclamanon marks for example. 


1090 LET z$-"CDcE3Ge4 6f! end of 
75th bar !egeA" 


The PLAY command wili simply ‘hop over any comments in the string 










'rumert with MIDI then the: +3 cán contro! it NIRE LAY Upto 
ntheaisers, drum machines ot sequencers The PLAY command 
i їп this se 
з number be and 16 The 
ed to Ыр) we es strnas c 





ection, except that cach strn 
after the ¥ controls 
be used the first (тос strim 


shouid inc 
vii 









lude à 
channel the 
bc played 
















the TV sound dow: г айо send MIDI 
programming ¢ jc number. Key 
veineities (100 ond 48 as 4 key 





velocity) 
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HE 
So, to senda little tune (mn fom vi 

handbook to find out ho 
command with fur 
illustrates the PLAY cc 









ез), you would 
ber. This examp 





10 LET a$="Y1T10802(((1CCgSb)) 
(CSESESbSD)) CCFFCSE)) CCGGDF 
)))" 

20 LET b$z"Y205N&R&&CSbfG)" 

50 LET c$="Y304((3C&)C&1CCDD(3 
SE&)SERTSESEEE(SFRDFRTFFSGS 
60368) 68 166$%ЕС))" 

40 LET d$-"Y4NO&&RR&ERRR(OSEGF7b 
5ср))" 

50 PLAY a$,b$,c$,d$ 


Summary table 


Finally, here | 
together with ti 


that can be used in the string af a PLAY command. 






со зоти ьо 
"m 


) 


N 
V 
W 
U 
x 
T 
¢ 
} 
H 
M 
Y 
1 
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Part 20 
File operations 


Subjects covered... 


Drives 

FORMAT 

Filenames 

SAVE, LOAD 

Disk catalog: CAT 
Wildcards 

MERGE 
Deleting and renaming files 
File attributes 

ERASE, MOVE, COPY 
The RAMdisk 

Tape operations 
VERIFY 

Tape catalog: САТ 


Drives 


The +3 has а built m disk drive that can be used to save and load your Own programs, and Io joad 
programs produced by other people. Asit ts also possible to connect a second disk drive to ће +3, 
BASIC must have some way of identifying which disk drive is which. The built-in drive 15 known as 
drive A (alwaysfollawed bya colon because +3 BASIC knows thatwhen yousay A. you mean ‘disk 
dnye A’) Ifthe external driveis present itisreferred to as drive B. 








As thé processor at the heart of the +3 can oni se with 64K of memory at a time, the extra 
RAM п the +3 s 128K m is used just like another dive. This 1s called the RAMdisk and 1s 
idennitied by the letter M. [ emory drive). Al! the commands (except FORMAT) that you can use 
оп drives A and В сап also be used on dnve M. Dnve М. is much faster than the mechanical disk 
miber that just like the contents of the program memory. the the 
p RESET button or switch off the +3. BASICs NEW 
stcred on drive М. intact, 














command, however, wili leave any fi 


If you dont havea second diskdrive connected ta your +3, you can still пзе the machine asif drive В 
Were present. ЇЇ you ask the machine to perform an opersnon on drive B. {youll see how tò do this 
later). a message wall appear asking you to 


Please put the disk for В: into 
the drive then press any key 
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„whereupon you should put the disk that you would have used mn dnve B: (ift had existed) into drive 

A. then press ап) кеу (for example ENTER). From then on, the machine will treat the built-in disk 
Чпуе asiftt really were dnve B. Whenthe +3 next needstc perform some operation on the disk that 
was orginally in the drive. it will ask youto, 


Please put the disk for A: into 
the drive then press any key 


This technique will be parnculariy useful when using the COPY command (described later in this 
section). 


Now that you know which drives are available and what they are called, let's see what they can be 
used for. Type 1 ће short program (which displays coloured squares) that you brat met at the end of 
part 6 1e. 


10 POKE 22527* RND *704, RND * 
127 
20 GO TO 10 


Thisisthe program that you ate going to save onto disk 


As previously expiamed (in chapter 6), you cannot stmply unwrap a brand new disk and hope to save 
programs onto it straight away, 1t must first be made ready to use with the aid of the FORMAT 
command. FORMAT will erase anything that was previously on the disk and set it up for +3 BASIC 
то use. Be careful, therefore. not to FORMAT any disk that has programs оп It you might like to keep 
To format your new disk, type in the following 


FORMAT "a:" 


if you haven't already put your new disk into the drive, don't worry-the +3 wil! just come back with 
theerrorreportDrive not ready 


Inthiscase put your new disk inta dne A and re-type the command 


By the way, while you ате using the vanolls disk commands you may occasionally see the report 
Drive A: not ready (possibly followed by - Retry, Ignore or 
Cancel ?) Thisinvarably means that you have forgotten to puta disk inito the drive 


Whenever a report appears that ends with = Retry, Ignore or Cancel ? there 
are three optionsopenta you 


The first is to take action te rectify the problem. for example, if the report was Drive not 
ready. then put à disk into the drive and type R (to retry) The disk system will then try te carry cut 
the same operahon again and hopefully this nme i will succeed, 


If you were hall way through copying a large file and an ertor such as Missing address 
mark appeared, this would usually mean that the disk being read has been damaged insome way 
Try R a few times and if the епот persists. you indeed have а damaged disk. At this stage. you'll 
probably wan! to salvage any un-damaged data so пу typing 1 {to nore). Although this tells the 
+3 disk system to ignore the error. there is по guarantee that all your data will be read intact - ite 
really justa last ditch operation when all eise has failed 
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_—_—_—— aaaaaaaaaaasssssssssssiIiIiIssase 


Finally, if you have tried to perform an operation where an error occurs, you may realise that there 1s 
no point in trying to go en. In this case type С (to cancel) which tells the +3’sdisk system to abandon 
the current command. Having typed C. BASIC will report an error (usually very similar to the text of 
the previous report). 


Back to our attempt to formata disk. If you have made a mistake and the disk you put into drive A. has 
already been formatted, the +3 will spot thisand you will receive the report 


Disk is already formatted, 
A to abandon, other key continue 


This is a Safety feature that will allow you to абагаол the format before the process gels going, il, by 
some chance, you inserted the wrong disk. In thas case you should type A (to abandon) and nothing 
more willhappen If. however you really do intend to reformat the disk and don't mind losing what's on 
її. thern-press any key apart from A (eg. press ENTER) 


Алег about 30 seconds, the usus! Ø OK report will appear The disk 15 now usable and should not 
need to be formatted again You can always reformat s disk if you wish to clear the disk of data 
completely, but remember that it isan irreversible process 


Disks can occasionally become spoilt (corrupted), This can happen if some aust or ditt comes into 
contact with the disk surface, if the disk is left 100 close to a magnehc field (such as that produced һу a 
TV or a telephone), if the disk is ejected While it 15 being wntten fo, or if the disk is left in the drive 
when the computer is switched on or off A corrupted disk will cause errors during LOAD or SAVE, 
and should be reformatted before апу more data is saved onto lt 


Ifyou want to recover files from a corrupted disk, you can try to copy them individually (using COPY) 
to a known qood disk. If one or more files prove uncopiable then you have probably lost them for 
good We recommend that you keep at least wo copies of important files (on different disks) - one for 
day-to-day use, and one kept in а safe place just in case the unthinkeble happens Making regular 
copies of valuable data and programs is known as backing-up. and i$ an essential habit to get into 
Backing-up сап save you untold misery and tears You сап of course make back-ups onto tape. which 
тау prove cheaper in the long run. 


Unlike many computers the FORMAT command is butit-n and can be used like any other BASIC 
command. It doesnt affect the program you have ir the computer, so you can now save the little 
two-line program you typed ina moment ago 


Турелп (һе followma. 
SAVE "squares" 
The word SQUARES is justa name that you use to label the program: you are gomg to store on disk, 


To prevent confusion. everything stored on disk must be gwen à name These names (called 
filenames} ате alittle different from those that you may use when storma proorams on tape. 
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Filenames 


The range of characters that you are allowed to use for disk filenames 15 more limited than for tape 
filenames. The format of filenames used on +3 disks is the same as that used by an operating system 
known as CP/M (Control Program/ Monitor) by Digtal Research Inc. The fact that these formats are the 
same means that you can takea +3 disk and use it on other computers Data can be transferred in 
this way between the +3 and а CP/M system. and this is most likely to be useful for people writing 
machine code programs or moving text from a +3 word processor to а CP/M program. (It is 
extremely unlikely that programs written in BASIC can be usefully converted from one machine to 
another using this method ) 


Filenames can be as simple as the example above - SQUARES (or even simpler - S, for example). 
However a full CP/M-type filename can be made up of as many as four parts. user number, drive letter, 
sname and type. Each of these partsis called а field (ес the name field or the type field). 


You needn't Worry about what user number means: i! you don't know already, then i's probably best to 
remain blissfully ignorant. However. for anyone who ts interested. on CP/M machines with very large 
disk capacities (or hard disks) with perhaps more than one termina! connected, user numbers are 
used to partition files into subsections (known аз user areas) so that there isn't just one huge directory 
‘with several thousand files On the +3. however disks cannot have more than 64 files so the use of 
User areas is not really necessary. Nevertheless user areas can be specified in filenamesusedin +9 
disk commands They take the form. 


usernumber drive letter + filename 


» Where User number is in the range 0 to 15. and drive jetter is A. В or М. И you specify a user 
humben then you must also specify a drive letter So, to save our example program muser area 5, we 
‘would изе. 


SAVE "5a:squares" 


The problem with using aser areas is thal it's quite easy to forget which user ansa you saved a file to, 
and so finding it could tske à while (asthe CAT command сат. only catalog one user area al à time) 


Ac just mentioned, the drive letter will normally be A.B or M: Nonce that the ener must be followed 
byacolonjea a:squares ш don! speci; à dnve letter then +3 BASIC wii use the буе 
thal was last used - this is ктот as the default dnve (When you first switch on the +8. the defaull 
drive eset to A.) So typing. 











SAVE "squares" 
15 fustas t you had typed 


SAVE "a:squares" 
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There are special forms of SAVE and LOAD which сап be used to change the default drive When 
SAVE ot LOAD is followed by a filename that contains nothing but а dnve letter and a colon, the 
drive denhhted by the letter isthen made the new default drive. So. 


SAVE "т:" 
SAVE "Squares" 


wil change the default dnve to drive M then save the program onto dnve М. {if the above 
command had been SAVE "m: squares” the program would still have been saved to drive М 
though the default driye would not have been changed.) 


Toswitch the default back to апе А. type 


SAVE "а;" 


Note that SAVE and LOAD followed by just à dive letter (and color.) will de паи orc tar 
change the default drive. They certainly wort saveor load a program: You must use SAVE et LOAD 
followed by a rea! filename for this 


The zame field of a ålename the only feld that you have to specify when using SAVE. LOAD. elc 
The name field can be from 1 to 8 characters long and may contain any of the fellowiria 


Letters abcdefghijkimnoparstuvwxyz (upperorlowercase) 
Dents 0123456789 
Othercheracters "#$'a1_{}~* 


Upper and lower case letters are the same in filenames so EXAMPLE ard example would be 
identical 


A filename cen end with an optional type feid (which ts just 4 further three characters) that you may 
wish to USE m Order to Group together files of the same type Ifa type field 15 specified, it must be 
preceded by a dot. (Unhke some other BASICs +2 BASIC does not automatically allocate a type 
field tc files if one ts not specified | You may find tt useful ro add your own type fields - à popular 
convention is to use the type fi + BAS to idennfy BASIC files and . BIN tc identify CODE tles 
(BIN bema short for binary), If you think this is а 9000 idea: then the previous example program 
could резатеа пет 








SAVE "squares.bas" 


The characters * and ? havea special mesning to +3 BASIC and cannet be used in a filenaine for 
LOAD апа SAVE There ате however fiie commandsin which * and ? can be used. and these will 
be discussed later 








_S— auaiiIaIanaaiiiIIaeeeaaaeaeasasasasasasasasasesesesasasosot 
Hereare some examples of valid filenames . 


2 
squares 
m:picture.bin 
a:fred 
13a:hello 
ÜM:CAPITALS 
test.bas 
philip 
glass.mus 
а:а.а 


Here ате some illegal filenames (and reasons why). 


pac man (must not contain any spaces) 

(test) (must not contam brackets) 

/<>-+=!& (птизї ло! contam any ofthese characters) 

excessive (more than 8 characters long) 

„bas (hasno name field) 

later... {only onedot allowed) 

7:dubious (ifuser number is specified, then filename must also contam drive. 


letter е9. 7а: dubious} 


Disk catalog 


You may have spotted the fact that we have now saved the sarie program twice with two different 
names (SQUARES and SQUARES.BAS) 1! would be mice to be able to check what has been 
saved on а particular disk. and this is where the CAT command comes in. CAT displays а catalog of 
what you have stored ona disk. 


Press ENTER then type in 
CAT 







їЙсоте en bniefly), and wili 
iphanumencal order and each 
icbytes (rounded up) At the end 


The 43 willtake a quick look at the disk (the read write indicator lan 
display a list of the disk's contents on the screen. The [ist is sorted int 
lile ts followed by ал indication of tts size to the nearest number of 
ol fhe list the amount of freespace on the disk is also displayed 











CAT (on its own) isthe simplest form of the command If you wanted to fist ай fhe fies on a different 


drive (eg drive М.) you would use 








CAT " 








When CAT is followed by a filename containing just a drive letter, ie. А: В: or M: (including ће 
colon), all the files on the nommated drive will be listed. САТ on its own gave a hstof the files on drive 
A, this is because A. is the current default drive. You will remember that LOAD or SAVE followed 
byadnve letter will make that drive the current default. So... 


LOAD "m:" 
CAT 


will also list all the files on dnve М. This isn't quite the same as CAT 
default drive has been left as M.. Change и back to A. before going further. 


We will now save several copies of our simple example program using different names, so that you 
will be able to see what the various forms of the CAT command will produce. So far the disk should 
contain SQUARES and SQUARES.BAS. If either of these weren't listed with the above CAT 
command, add theirname to the list below. Type the following. 


SAVE "fred" 
SAVE "fat" 
SAVE "santa.bi 
SAVE "trepur.bak 
SAVE "cliff.cjl" 
SAVE "sausages.bas" 





"^, because now the 





Don't worry about cluttermg up the disk with lots of copies of the same thing - you'll be shown how files 
can be erased later, 


Wildcards 


Ifa disk hasa large number of files. soften desirable to selectively list only those of mterest The +3 
catersforthis. If, for example you wished to list only those files that ended im . BA S you would use. 


CAT "+. bas" 


The astenx character * 1s what's known as г wildcard When a filename. perhsps containing a 
1.16 specified. CAT will list only the files that match the specification given, When the * 
òrd ts used (in either the name field or the type field) :t means ‘any character from here to the 
end ofthis field. Sc and, we want CAT to display any files that have any characters 
inthe name field an в AS in their type field. If there are no files on the disk that match the 
ation, the report No files found will be displayed (followed by the amount of free 
space) If you give 2 file specification of #„# (е CAT "%.*"") or no specification atall бе CAT) 
and the report No files found is displayed. then this means that the disk 1s empty. An 
empty disk in drive A or В will have a free space value of 173K. (this value may be different for disks 
from other types of computer} An empty dnve М will usually have 58K free If you catalog a disk 
contaming a commercial program (such аз а сате) it maht appear to have no fiesonit but very little 
space free Thisis а protection measure taken by the software writers to prevent illicit copying, and 
shóüidntcanse. ncem 
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Ifweuse. 


CAT "s*.bas" 


then all files that bean with the letter S and then have any characters whatsoever belween ће S 
and the end of the name field, followed by a type field of BAS, will be shown. Files with the names 
SQUARES.BAS. SAUSAGE.BAS SUPER.BAS would ай be listed, but 
SQUARES.BIN TOAST. BAS and SQUARES would not 
The * wildcard can also be used in the type field of а filename (note. however, thet you cannot use itin 
place of the user number or drive letter). If we wanted to list all files that had SQUARES as their 
name field and anything as their type field. we would use 


CAT "squares.*" 


Similarly. if we wanted to list all the files that began witha letter S and had a type field that began with 
the letter В we would use 


CAT "уж, be" 


When we type CAT (on its own), we want to list all files on а disk. Therefore, САТ з just a shorthand 
way ôf saymig. 


CAT EWY 


From the above you will notice that ће * wildcard can only be used as the last character ma field. and 
itis used to mean T доп? care what other characters are present between here and the end of this 
field. Sometimes, however, you may want to specify а group of files but need to be а little more 
discerning, This is when you use the ? question mark wildcard (in either the name field or the type 
field). The ? wildcard means 1 dont mind what character happens to be in this specific position 


Therefore. if we used the command 


САТ "?at" 


then the files listed would be al! those that are three chatacters long, ending in AT but we don't 
mind what character is m the first position Thus files such as CAT, SAT, MAT and FAT would be 
listed. but CAR, CATTLE and AT would not, Unlike ће * wildcard ? wildcards can be used in 
place of any of he 8 characters of the name field and the 3 characters of the type field. There is до limit 
to the number of question marks you can use (other than the 8 and 3 limits of the filename field lengths) 


Valid file specifications containing ? wildcards include 


?.bas {one letter name yntha rype field of BAS) 
s?uares.* (specific files whose second cheractér doesnt matter. withany type field) 


(files becinning СА wath four characters in the гате field. and with а 
type field of characters whose second letters Т) 
222222?3.22? (exactly thesameas* . *) 
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Ifyou have a printer connected to your +3 you may find it useful to print-out the files listed by CAT 
‘You can do this by directing the output from САТ to stream 3 (streams are explained in part 22 of this 
chapter). The command to do thisis. 


CAT #3 


If you only want some of the files printed-out, you can also include a file specification in exactly the 
same way as before For example 


САТ #3,"a:*.bas" 


(The above CAT #3 commands will not work unless a printer is connected to the +3 and is on 
lme Toabandon. press BREAK.) 


Any form of the CAT command may also end with the word EXP, for example, 
CAT "as" EXP The EXP is short for expanded. and as the name might suggest. gives you à 
е more Information about the attributes of the files on ё disk. Not only will the expanded catalog 
display system files but also it will indicated whether files are set Io write protected mode, archive 
mode or system status (these terms are explained in the section ahead entitled File attributes), 


(There is one other specialist use for the CAT command, and this will be dealt with in the section 
ahead entitled Tape catalog ) 


Now that you have successfully saved a program to drive A. you can happily switch off or reset 
the +3, от start a NEW program. knowing that you could always load in the saved program if you 
needed if. Remember - there is а difference between resetting the #9 and using the NEW 
command -if you reset, all the +3 `5 memory (RAM) will be cleared. This includes any files you may 
havesavedondnve М. When you use NEW, however. any fileson dnve M. will remain intact. As we 
have saved the program on the disk in drive A , you can go ahead and press the RESET button. then 
release it. The usual opening menu will be displayed. Select +3 BASIC then type the command.. 


LOAD "squares" 


The LOAD command reads in а new program (and variables) from disk and then deletes any 
program (and variables) previously in the memory. (If the program that you specified to load isnot an 
the disk then any program currently in the memory 1s not deleted.) Just ike SAVE, the LOAD 
command must be given a filename whose name field is at least One character long. If you have been 
used 10 з tape machine im ће past then you may have used LOAD "" to mean ‘оаа the next 
programon the tape The concept of a next program’ on disk does not exist, зо if you don't specify а 
filename. the disk system: won't know whe! to load and will report an error. Ifyou can remember what 
name you saved a file under, use CAT to check what's оп the disk (this is why it's а good idea Io save 
programs on disk using mnemonic names (names that remind you what they contain) - eg. 1t i8 tnare 
obvicus what sott of program a file named TENNIS . BAS contains compared to бле simply named Т\ 









There isa short cut for Joading programs (such as games) that have been specially set up - you can 
select the Loader option from the opening menu. This option. when selected attempts to load and 
тап programs First ofall, it looks fora program called * on the disk Ifthis exists then if will be loaded 
and rum. The program has m be a machine code program saved ma particular fashion (as BASIC сайт 
use-* asa filename for SAVE) ands therefore. only for use on commercial software or by those who 
understand machme code 
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If * can't be found, the +3 will then look fora file called DI SK This can be a BASIC program that 
you've previously written and saved, so И the Loader option finds a program called DISK, it will 
load ц апа want for the next operation 


Atthtspomt, pressmg ENTER wil! just load the program again 


Ifyou wish to run or edit the program after it has loaded, first pressthe cursor down key <= once, then. 
ENTER Thisselectsthe +3 BASIC opnon fromthe opening menu 


Ifthere isnt a program called DISK onthedisk (or ithe +3 detects that there isn'ta diskin the dise 
drive), then the computer will try to load a program from tape, displaying the message. 


Insert tape and press PLAY 
To cancel - press BREAK twice 


This ts the recommended method for loading Spectrum +3 (Spectrum +2 and Spectrum 128) 
software from tape (see chapter 4) 


As previously mentioned, LOA D deletes the old program and variablesin the +3 whenever tt loads 
in the new ones from disk However, there ts another command - MERGE. whichis similar to LOAD 
‘bur it oniy deletes an old program line or vanable i! there is à new one with the same line number or 
name Clear the program memory using the NEW command. then type in the ‘dice’ program from part 
| Lofthischapter and $ АМЕ it ento disk. using 


SAVE "dice" 
Use NEW to clear the program memory again, therenter ard run the following program, 


1 PRINT 1 
2 PRINT 2 
10 PRINT 10 
20 LET x=20 


Now type ir. 
MERGE "dice" 


Ityou then LIST the program you will see that lines | and 2 have survived, bat lines 10 and 20 have 
been overwniten by those from the dice program. Note that the value of the vartable x has also 
survived (try PRINT x), 


You have now seen simple forms of five of the commands that wrk m comuriction with disk 


FORMAT Prepares brand new disks so that programs сап be saved onto them 


FORMAT can be used to completely erase everything on а disk that has 
already been used 


SAVE Stores the programand variablescnto a disk. 


LOAD Clears the computer of al! tts program and variables; andreplaces thertiwith 
flew ones tend in from disk 
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MERGE Snmilar to LOAD except that и does not clear the old program lines and 
vartables uniess tt has to (because they are the same as those being loaded m 
from disk) 

CAT Displaysa list of the files contamed ona disk 


A vananton SAVE takes the form 


SAVE filename LINE number 


A program which ts saved using this command. is stored in such а way that when it 1s loaded, |t 
automatically jumps to the Ime wath the given number, then runsitself 


Use NEW to clear the program memory then type m the following. 


10 PRINT "program running" 
20 PLAY "cdefgabC" 


Now save this program usitig the command. 
SAVE "disk" LINE 10 


Now reset the +3, and when the main menu appears ensure that the disk (with the above program. 
on ft) isin the drive then press the ENTER key. This wll select the Loader option which searches 
for a file on the disk called DISK. When it finds the simple example program you just saved, it will 
ibad it. and asit wassaved using a LINE parameter. it will automatically start running (from line 10) 


Atthispomt pressing ENTER will load and run the program agan 


If you wish lo edit the program aiter it has run. press the cursor down кеу «> once then ENTER This 
aeiéctsthe +3 BASICoptionfrom the opening menu 


Note that if you load a program calied DISK which doesnt automatically run (using the Loader 
‘option from the opening menu), then you wil! have to select the +3 BASIC option (after the program 
has loaded) before уой can rumitor edit it 


Sc far, the only kinds of information we have stored on disk have been programs (together with (heir 
variables) There are ilso two other kinds of mformation. called arrays and bytes. 


You can save arrays on disk using the keyword DAT A in à SAVE statement 


SAVE filename DATA array name C) 


where tilename is the name that the informanon will have on osk and works in exactly the same way 
as When you save a program 





The array name specifies the array you waht to save sc ft is just 
Remember toput the brackets €) after thearra 


Mer (or à leser followed by $) 
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Be clear about the separate rolesof filename andarray name If youssy (for instance) 


SAVE "bloggs" DATA b () 


then SAVE takes the array ЫС) from the computer and stores и on disk tinder Ihe name 
BLOGGS 


The command. 


LOAD "bloggs" DATA b () 


sees if itis possible (о Joad the array (ie if ћете 1s room for iin the computer) tlienifso deletes any. 
already existing array called b € ) and loads m the array BLOGGS from disk. calling it b C) in the 
computer 


You canriet use MERGE withsavedarrays 


Youcan save character (string) erraysin exactly the same way However, note thatwhen you load ina 
character array, 1 will delete not only any previous character array with the same name, but also any, 
simple string vanable with the same name 


When dealing with a large amount of data you may find t useful to use the SAVE, DATA option and. 
the LOAD DATA option to and from dnye M. Once saved on drive M the space previously used 
by an array can be re-used. Using drive М will mean that saving and icading ате very fast 


Byte storages used for preces of mformation without any reference to what the mformations used fot 
-it could be а screen display, or perhaps some user-defined graphics от just something you have 
made up for yourself [t is specified using the word CODE. asin. 


SAVE "picture.bin" CODE 16384,6912 


The unit of storage in memory is the byte (а number between 0 and 255), and each byte has an address 
(whichis а number between 0 and 69535) The first number after CODE is the address of the first byte 
to be stored on disk; the second number is the amount of bytes to be stored In ош case 16384 is 
the address of the first byte m the file (which contains the screen display). and 69 12 isthe amount of 
bytes in it, sò We are saving an actual copy of the screen display omte disk Try the above SAVE 
command (You don't have to save the bytes usma the name PICTURE.BIN - its merely а 
convenient reminder of what'son the disk ) 


Toloadit back. use. 


LOAD "picture.bin" CODE 
You Gan pul perametersatter CODE ic tlie Hrm 


LOAD fieisme CODE stai! , length 
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Here, the length parameter is used аз a safety measure - when the computer attempts to load the 
bytes from disk И Will check the lenath and refuse tc load the bytes if there are more than specified 
(thereby safeguarding against the extra bytes accidentally overwriting an area of memory that you 
wished ta preserve). In such a case, ће report Code Length error isdisplayed (Anyone 
using а cassette urit under 48 BASIC should note that rhe above error will display a different report 
R Tape loading error) 


Ifyou leave out the lenathparameter the +3 will readin the bytes howevermany there are 


The start parameter shows the address where the first byte is 10 be loaded back to ~ this can be 
different ftom the address it was saved from, though if they are the same, then you can leave out start 
parameter inthe LOAD statement 


CODE 16384,6912 issuch a useful area of memory (the screen display) to save and load, that 
especial function (S CREENS) has been provided to represent it. so you can type (for example). 


SAVE "picture.bin" SCREENS 


LOAD "picture.bin" SCREENS 


Automatic back-ups 


li you have saved one or two things on à disk and then you save something with à fenare that has 
already been used. what will happen? Well. each time you save à program. the disk system checks to 
see t the filename you specily has already beer used. Ifithas the existing copy on disk is qiven a new 
Шелате before the jnformanon you have asked to save is stored The new name given to the existing 
file has the same name held but tts type field will always be . BAK (short for backup). 


Ifa „ВАК version of the file already exists, then that will be lost in preference to the new „ВАК file. 
‘This means that as you Save successive versions of a program with the same name the previous copy 
will stili be there m а file called filename. BAK. So. if you make a serious programming error and 
inadvettently save the program, you can delete the newest version and rename the . BAK file to the 
опата! filename. The next section shows you how to do this, but first, type. 


SAVE "a:squares" 


fosave the progranrusing the filename SQUARES yet again. 
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Deleting and renaming files 


Files can be deleted from a disk using the ERASE command Тїшє should be followed by a filename 
that specifies which file ot files are to be deleted Just like CAT youcan use the wildcards * and ? to 
identify a group of files or you can specify the name 1n full if you only want fo get nd of one particular 
file Ifyou specify a single filename, that fiie will immediately be erased from the disk - so take care. If 
you specify a group of files (by including * or ?). BASIC will ask you to confirm that youreally mean ta 
delete this group of files Typing Y will make the deletion process continue so if you have made а 
mustake, type N. 


Tf. forexample, you wanted to deletes ile from drive M. called FRED. BAS. you would use 





ERASE "m:fred.bas" 


Itcitive M. has already been set as the default апуе, then you don't need to include the M at the start 
the filename. It doesn't hutt to iiclude the drive letter anyway. and with as powerful a command as 
ERASE, you might feel safer if you do. Te erase al! the filesoz drive B. you would use 


ERASE "b:*,*" 








Before doing tins, BASIC. will ask for confirmanon 
Erase b:*.* ? (Y/N) 


ала assummag that yeu realy m 





in e wipeall the ties from the disk m dye В ycu would then type Y 





If you ask to delete а single file (or а group of files using ће wildoards * and ? j and there are no files 
on the disk that match the speciticaton then thereport File not found willbedisplayed. 


Note that ERASE followed by just à drive letter (eg ERASE 3") wall erase all files on the 
specitied drive without asking for confirmation Be careful. therefore, not to enter this form of the 
command unless you really mean tc delete everything (The ERASE process wil! stop and report ary 
error ifa write protected disk cr file is detected } 











The disk you have been using up to now has many copies of the simpie SQUARES program (saved 
under different names) on it This is а waste of space so you might as well erase those that arent 
needed What you want todo in effect 15 erase everything except SQUARES (though there ts по 
simple way to do this) However some of the бетеп files have the same Common. sò you 
may be able to use Various forms of # and ? specifications fo cut down the at aftyping See буба 
сап workout the fewest шип RASE commands to erase ali filesother than SQUARES. 




















Once а fiie hi saved it can be c 
there 1s M called SQ! 





:squares" 
squares" TO "m:blocks" 
"mi" 
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Imagine we had saved a file called FRED, and then after working on it and saving a new version with 
the same name, realised that we had made а terrible mistake and would like to recover the last 
version. This would be possible using the commands. 


ERASE "fred" 
MOVE "fred.bak" TO "fred" 
Unlike ERASE youcannot include the wildcards * or ? when renamtng files. 


MOVE will take into account the current default dnve so the filename doesn't necessarily have to 
contain a drive letter. Note, however, that it 1s not possible to use MOVE to rename files between. 
different drives. The command. 


MOVE "a:fred" TO "b:eric" 


(for example) will fail with the error No rename between drives reported Instead. 
you can use the COP Y command (explained ahead) followed by ERASE to achieve the desired 
result 


File attributes 


MOVE has another use besides renaming files It can also be used to change the attributes of a file 
Attributes are bits of information associated with a file that tell you (and the computer) a little more 
about it 


There are three attributes that can be changed The most useful atribute 1s wnte protection. Once a 
files write protection attribute has been set. 1t will not be possible to erase it (or save a file with the 
same пате) unhl you remove the write protection It behaves a little like the wnte protect hole on the 
disk, but works just on individual files Unlike the write protect hole. however, it offers no protection 
against FORMAT which erases everything on а disk. regardless of attributes. You can set a Пес 
wnte protection attribute to on with a command such as. 


MOVE "squares" TO "+p" 
‘The letter P isshortfor protection (against overwnting). If you now try to use the command... 
ERASE "squares" 
you willreceive anerrorreportsaying File is read only 
‘Teswitchwnte protection off use 


MOVE "squares" TO " 
and you ll beable te erase the Ме as before. 





паї the MOVE commands that change attributes. + means swntch ton, and = means switch itoff 
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When you are using MOVE to change attributes, the filename can include the wildcards * and ?. So 
tomakeall the filesondnve M. write protected, you would use. 


MOVE "т:*.*" TO "+p" 
Asalways, the dnve letter can be omitted if ins the current default anve 


You can repeatedly switch attributes on or off without causing an error. so if you setwnite protect on à 
file that hasalready got уте protection it will just stay protected. 


The second attribute that can be changed is known as the system status artribute. This 15 really 
provided just to be compatible with other CP/M based computers; however. if you do set a files 
‘system attribute to on, then you wall notice that the file no longer appears in the hist of files when you 
use CAT. The system status attribute is identified by +5 (or ~$) in the MOVE command If you use 
the expanded catalog (ie. CAT EXP) all the files will then be listed including system status files 
(which are followed by the letters 5 Y S). You may also notice that any files tha! are wnte protected 
are followed by the letters PROT You can use the system attribute to remove files from a catalog if 
they would otherwise just clutter things up. 


Bear in mind that you cannot have two files on the same disk-with the same filename and different 
system status attributes, so if you try to create or copy à file onto a disk where a file of that пате 
already exists (but is hidden from CAT) then the previous file will be deleted. 


The final attribute you can change ts known as the archive attribute. In an expanded catalog it shows 
upas ARC, and is identified by +A (or - A) in the MOVE command. On ће +3. the archive attribute 
tsofno practical use and is only provided for file compatibility with CP/M based computers 


Here are some attribute-setting MOVE commands See tf youcan predict what they will do 


MOVE "ж.ж" TQ "+p" 
MOVE "*.bas" TO "-s" 
MOVE "5227, ж" TO "+a" 
MOVE "m:2.2" TQ "=p" 





Ifyou try to use any letter other than А, S or P insettmg or resetting attributes. ot ifthe armibute string 
isnot two characters jong, then you willreceiye thereportInvalid attribute 


Quite offen, а situation will arise when you would like to make а copy of one of your files (to give to à 
пела perhaps ot to pul i on drive M. so that # can be accessed quicker) The COPY command сап 
be used to copy files from one drive fo another and even to make complete copies of disks The vety 
simplest form of the COPY command will look something hike this 





COPY "a:fred" TO " 


‘This means put а copy of the contents of the file called FRED (winch is presently on drive A.) on]o 
drive M. Asno destination name has been specified (after М.), the new file willalso be called FRED 
The name before the word TO is known as the source filenaine and the name after ТО is the 
destination filename. 
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The command 


COPY "fred" TO "eric" 


will take the contents of a Ше called FRED on the defaut drive and copy it fo а file called ERI C. 
also on the default dnve. The files FRED and ERIC then cantamn the same information 


You cannot copy one file to another with the same name and on thesemednve Trying to do so will re- 
sult in the error report File already exists (cr possibly File already 
in use 





COPY "a:*.ovl" TO "m:" 


will work (assuming that there are some files cn drive A that match this specification) апа transfers 
all fileson A. witha «0 VL type field onto drive M. However. the command. 


COPY "a:*.bas" TO "m:*.bin" 


wil fot vaththeerrorrepor Destination cannot be wild 


The COP Y command does not copy any attribute information associated with à file. you have to set 
any attributes you require on the new file after copyina, 


COPY will always hst the files А is copymg rc two columns This wi)! allow you to check that Any 
wildeard specificanon you use encompassesal the files that you were interidina to сору. 


Atter copying. a report will appear to let you know how many files were copied. (If you were copying 
i groupof files, this may be useful to check that you have indeed copied all the files you intended ta ) 


Thore tsa special form ofthe COPY commandas follows 


COPY "as" TO "b 


which will perform a complete sector by sector copy of the disk in drize A to an already formatted 
сек m dnve В. Anything already stored on the disk in drive B. will be lost -so ii there are only a few 
hieson the source disk to be copied ttmay be quicker To use 





COPY "a:*.*" TO " 





f you have only one dnve (A ). you can use the fact that the smoie mechanism сэп be used às if)! 
Лот dive Б. For example. suppose you have a single drive system ana want to copy a 
upe of files (that both end in . BAS) from one disk to another Put the source dise 1) the drive and 
уре. 
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COPY "a:*.bas" TO " 











Oncethe +3 hasread partof the first file that ends m . BAS, itwillask youto. 


Please put in the disk for B: into 
the drive then press any key 


Simply follow this instruction. After ће +3 has wntten the information onto the dnve B. disk. it will 
ask youto... 


Please put in the disk for A: into 
the drive then press any key 


This process of swapping between disks will go on until all files have been copied, Because the 
COPY command will try to use any free space on drive М. if is г good idea to clear drive M. (if 
possible) before doing a lot of copying (as thiscan reduce the number of disk swaps needed) 


As well as copying files between drives COP Y can also be used to copy files to the screen ot toa 
printer (if connected). The command. 


COPY "wuords.txt" TO SCREENS 


will display the contents ofa file on the default inve called WORDS. TXT. Any control characters 
(except carriage returns) will be filtered out. This command cannot really be used to look at BASIC 
program files as they contain various control codes Its main use will be to inspect the contents of 
ASCI text files such as those produced by à word processor 


‘The command. 
COPY "words.txt" TO LPRINT 


assimilar to the above, but this ume the contents of the file will be sent to the printer In this case 
however, control codes will be sent tå the printer Ifyou have the print output to be via the RS232 
with tokens unexpanded (using FORMAT LPRINT "R";"U"), then this command can be 
used 10 ‘export’ files to Other computers Once again. this command cannot be used for BASIC 
programs - itis intended for sending ASCII text files only 






People writing machine code programs may find it easier to do so опа larger development machine 
However. the files produced by this method wil! probably not be recognised by the +3, as BASIC 
expects (о find a 128 byte header a! the start of each file which contams information used by the 
LOAD command. However. once а binary file has been produced on a +3 formatted disk. it can 
havea header of the correct type put on itusing а command suchas 


COPY "game.com" TO SPECTRUM FORMAT 


‘This will produce a new file on ће seme drive. having the same name fiela but with a type field o: 
«HED (short for headed) Inthe above exampie a new Ше called GAME. HED wiii be created, and 
will be written to the detauit inve (as no drive tetter wasspecified) 
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Obviously this command will only be of use for machine code files. Headed files produced in this way 
will have the length part їп their header set to the correct value and the type part set to be a CODE 
file However, BASIC cannot know what address the file should be loaded to, so the load address 
shoüld be specified when the LOAD..CODE command is used. For example, tf the above program 
had been assembled to execute at 7000h (the л denctes a hexadecimal number) от 28672 decimal, 
then the headed file conid be loaded with the command. 


LOAD "game.hed" CODE 28672 


As SCREENS filesate just another type of CODE file, this technique can be used to import screens 
designed on another machine. though they obviously wouldn't make much sense unless they had 
been tailored (o fit ће 3 'ssizeand layout 


The RAMdisk 


‘You may have been wondermg what point there їп storing information їп the RAMdisk (drive M.) as 
1t will be lost once ће +3 is switched off Well. perhaps the most obvious use of drive М. 18 to store 
chunks of BASIC program (or routines) which can be merged (using MERGE Mz filename) into à 
smaller program. n sequence This makes t possible to wnte about 90K of BASIC program. and hold it. 
inthe +3 (thoughto do this, the program structure has to be well defined). 


Youcan keep the various routines on a 3inch disk and use COPY to put them mto drive M. before you 
run the program. The benefit of doing tms is that dnve М, is much quicker to access than the 
mechamcal drives (A and B.). The mechanical drives. however, can hold much more data, so you 
might like to evolve a system using both disk and RAMdisk. Careful design and planning will repay 
itself many nmes over in termsofspeed and performance 


One of the more interesting uses of the RAMdisk 1 n animanon where а senes of pictures can be 
defined by a ‘slow BASIC program, stored in dnve M, then called back tò the screen at high speed. 
The following program offersa taste ofthis Doubtless you can do better 


10 INK 5: PAPER Ø: BORDER 0: С 
Ls 

20 FOR f=1 TO 10 

30 CIRCLE f*20,150,f 

40 SAVE "m:ball"* STRS (f) COD 
E 16384,2048 

50 CLS 

60 NEXT f 

70 FOR f=1 TO 10 

80 LOAD "m:ball"* STRS (f) COD 
E 

90 NEXT f 

100 BEEP 0.01, 0.01 

110 FOR f=9 TO 2 STEP -1 
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120 LOAD "m:ball"* STRS (f) COD 
E 


130 NEXT f 
148 BEEP 0.01, 0.01 
150 GO TO 70 


Before running this program, always make sure that dnve М. is empty. If it isnt, first type 
ERASE "mz*.*" (typing Y atthe (Y / N) prompt), then RUN. 


Note that in Ime 40 of this program. the two numbers following CODE are the address in memory of 
the start of the screen (16384) and the length of the top third of it (2848), Bv saying and loading 
only thetop third, the overall speed ts maintained. 


Tape operations 
(See chapter 10 (Peripherals for your +3) fordetails on how to corinect a casselte unit toyour +3.) 


Much of what has been said in this section about the use of LOAD, SAVE and MERGE on disk will 
apply equally on tape (if you have connected a cassette unit to the +3), However, the commands 
FORMAT, COPY, MOVE, CAT and ERASE do not apply on tape (although there is a special form 
of CAT that can be used - described in the section ahead entitled Tape catalog’), 


As you will already know, when you first switch on ће +3, the default drive forall file operations is set 
to drive A.. This means that if you use CAT, ERASE, LOAD, SAVE, etc. without specifying a drive 
letter, then +3 BASIC will perform the operation on drive A... You will also know that the default disk 
can be changed using etther. 


LOAD "driveletter : " 


or 
SAVE "dnyeletter : 


where dnve letter is either А 2, В: or М: (which must include the colon) In fact you can also use 
T: asadnve letter, butonly in thisone special form of the LO A D andthe S A V E command... 


LOAD "t:" 


After LOAD "е: ", all subsequent LOAD and MERGE operations are performed to tape (until 
changed back to disk by, forexample. LOAD "а: ") Similarly if you use. 


SAVE "ts" 


-thenallfuture SAVE operations will be performed to tape (again, until changed back to disk by, for 
example, SAVE "a:") Unlike Az, B: or Mz, when youuse T : asthe dne letter, it will change 
only future LOAD, SAVE and MERGE commands. The default drive used for MOVE, COPY, CAT 
and ERASE willstay the sameas it was before (as these commands have no relevance to tape). 
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If all this sounds a little complicated, a few examples might help to make ita little clearer. Assuniing 
you have just switched on (or reset) the +3, the default for all operations will be A. So if you now 
type 


SAVE "ті" 


{hen the default drive for all subsequent operations will be set to drive M. (this i exactly the same as 
lithecommand LOAD "т: " had been used) Using the command 


LOAD "b:" 


will then set the default drive for all operations to drive В. For this sort of thing, LOAD and SAVE 
operate m exactly the same way 


Ifwenow use the command. 


SAVE "t:" 


this will perform all future $ AV E operations to tape. but all other commands will still default to drive 
B. Using the command.. 


LOAD "t:" 
will also perform ай future LOAD and MERGE operations to tape: however. the default drive for all 
disk-only commands will still be drive В. 
Finally, using the command. 


SAVE "az" 


Will perform all future SAVE operations and ай disk operabons (except LOAD and MERGE) to 
аел: LOAD and MERGE wilistill be from tape, however 


Let's try to save our simple squares program onto rape. Reset ће +3 rhen type. 
LOAD "squares" 


This should load inthe program that we saved earlier. If you press ENTER, the program will be listed 
as follows. 


10 POKE 22527+ RND *704, RND x 
127 
2@ GO TO 10 


This is the program that you are now going to save onto tape, Any standard tape should work, although 
lownoise tapesare preferable 
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Typein the following. 


SAVE "t:" 
SAVE "squares" 


This will save the program onto tape using the filename SQUARES. When saving fles on tape, you 
are allowed up to ten characters in the name. Unlike disk. you can use any characters you like and the 
name can include spaces. 


The +3 willdisplay the message. 
Press REC & PLAY, then any key. 


We shall first go through a ‘dry run so that you can see what wili happen when we actually do save the 
program later. This time, therefore, don't press REC and PLAY on your cassette unit - just pressa key 
on the +3 (ior example ENTER) and watch the border around the screen display You will see 
patterns of coloured honzontal stripesas follows: 


Five seconds of ted and cyan stripes moving slowly upwards followed by a very short burst of blue 
and yellow stnpes 


A short pause. 


Two seconds of the red and cyan stripes again. followed by another short burst of blue and yellow 
stripes. 


While the stripes appear on the screen. you can also hear the ‘sound’ of the data through your TVs 
speaker 


Keep trying out the above SAVE command (without actually operating your cassette unit) until you 
can recognise these patterns. What's actually happening is that the information ts being saved m two 
blocks and both blocks have à ‘lead-in’ (which corresponds to the red and суап stripes) followed by 
the information itself (which corresponds 10 ће blue and yeilow stripes). The first block is a 
preliminary one containmg the name and vanous other bits cf information about the program, and the 
second is the program itself together with any vanables present. The pause between them is [ust а 
gap 

Now let'sactually save the program onte tape 


|, Wind the tape to an area that is either blank. or that youere prepared tooverwnte 
à Type, 

SAVE "squares" 
3, Follow the instructionson the screen. ie. 


Press REC & PLAY, then any key. 
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4, Watch the screen as before. When ће +3 hasfimshed(withthereport@ OK), stop the tape. 


Whenever you save а program to tape before clearing the saved program from the +3's memory; 
you should always make sure that the program was correctly saved. You can check the signal on the 
tape against the program in the memory using the VERI F Y command (this command isn't used оп 
disk, as disks are по! prone to the same sorts of errorsas fapes are). 


| Rewind the tape to just before the рош! at which yousaved the program. 


2 Type.. 
VERIFY "squares" 


Play the tape. The border will alternate between red and cyan untl ће 4-3 finds the program that 
you specified, then you will see the same pattern as you did when you saved the program. During the 
pause between the blocks the message Program: squares will be displayed on the 
screen. (When the +3 1s searching for something on tape, it displays the name of everything it 
comes across.) If, after the pattern has appeared, the +3 displays the report @ OK, then your 
program 1s safely stored on tape and you can skip to the section ahead entitled ‘Verified ОК. 
Otherwise, something has gone wrong -take the following steps to find out what 


If the program name has not been displayed, then either the program was not saved properly in the 
first place; or it was but was not тега back properly. You need to find out which. To see if it was saved 
properly, rewind the tape to just before the рош! at which you saved the program, then play it back 
while listening to the TV's speaker The (red and cyan) lead-in should produce a clear, steady high 
pitched note, while the (blue and yellow) mformation part gives a much harsher screech. 


Jf you do not hear these noises, then the program was probably not saved. Check that you were пог 
trymg to save the program onta the plastic leader at the beginning of the tape When you have 
checked this, try saving again 


1f you can hear the sounds as described. then SAVE was probably alright and your problem is with. 
reading back 


It could be that you mistyped the program name when you saved (in which case when the 4-3 finds 
the program it will display the mistyped name on the screen) On the other hand, perhaps you 
mustyped the program name when you verified it, in which case the +3 will ignore the correctly 
saved program and carry on looking for the wrong name. flashing red and cyan as it qaes 


If there ‘is а genuine mistake on the tape, then the +3 wil display the report 
R Tape loading error which means in this case that it failed to venfy the program. Note 
that а sight fault on the tape itself (which might be almost maudible with music) can wreak havoc with 
а computer program. Try saving the program again, perhaps on a different pari of the tape (or a 
different tape altogether), 
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Verified OK 


Now let us suppose that you have saved the program and successfully verified it. Loading it back itilo. 
the memory isjusta matteroftypina. 


LOAD "squares" 


(Since the program venfied properly. youshould have no problem loading jt.) 
LOAD deletes the old program (and variables) inthe memory when it loadsin the new one from tape 


Once a program has been loaded. the report @ OK will appear. The proaram can then be run or 
edited. 


Asmentioned m chapter 4, it is possible to buy pre-recorded programs (software) on tape. They must 
be specially written for the ZX Spectrum range (le. the Spectrum, the Spectrum +, the Spectrum 128, 
the Spectrum +2 or the Spectrum +3) Different makes and models of computer have differerit 
waysof storing programs, so they cannot use each others tapes 


Ifyour tape has more than one program stored on the same side, then each program will have a name. 
You can choose the program you wish to load using the LOAD command - for instance, 1! the one you 
wantis called HELICOPTER, you could type. 


LOAD "helicopter" 


The command LOAD "" means load the first program that ће +3 comesacrosson tape’ This cán 
be very useful if you cannot remember the name that you saved the program under (Remember that 
thisonly works on tape -normally you cannot specify a blank filename ) 


When there 15 no disk i drive A. (or the disk contains no file called * or DISK), then the option 
Loader from the opening menu has ће same action as LOAD "" from tape, and is much 
quicker to use -simply switch on (or reset) the +3 and pressENTER 


MERGE will operate in а similar way to that desctibed for disk except of course that on tape you can 
use MERGE "" (о mean merge the next file on tape’ Filenames in a MERGE command may 
conform tothe lessstringent limits for tape (іе any combmation of 10 characters including spaces) 


If you have BASIC programs saved on tape (perhaps because you owned a previous Spectrum 


model), you will probably want to transfer them to disk to gain the advantage of faster loading This 
should be relatively straightforward Just use 


LOAD "t:" 
SAVE "а:" 


then for each BASIC file on the tape. use: 


LOAD "" 
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which will load the next file from the tape mto ће +3's program memory. Once loaded, the file can 
besaved out to disk using 


SAVE filename 


Remember that files on disk must be givena filename which conforms to the limitations outlined at the 
beginning of thissechon. 


If the BASIC programs have been saved with an automatic execution LINE. you will find that 
attempting to LOAD them val also run them. Obviously you don't want this so, for each program you 
wish to load, reset the computer, select +3 BASICandtype 


MERGE "" 
(ratherthan LOAD "") 


Ifyou have saved data (numencor string) arrays, М should be an equally simple matter to LOAD them: 
into memory from tape; then S A V E them to disk 


The only file types that may cause difficulty when you want to transfer them from tape (0 disk are 
CODE (and SCREENS) files To be able to transfer a file of this type you need to know at least two 
things about it. 


1. Theaddressitwassaved from. 
2, How many bytes it contams. 


Tape catalog 


Thisis where the final form ofthe C AT command comesin Ifthe file specification given ts simply Т : 
aspecial formofthe САТ command comesinto action. After youtype. 


CAT ME 


the +3 will wait for you to plays tape (the САТ “t:" operation can be abandoned by pressing 
BREAK) When the +3 finds a header cn tape и will display the information (in the same form if was 
saved) This means that there will be a ten character filename in mverted commas What follows the 
filename will depend upon the type of file - 1f it is а BASIC program ће word (BASIC) will be 
displayed. Ifa LINE parameter was specified when the file was saved. this will also be shown. If the 
file holds data. then the word DATA followed by the array name will be displayed, and finally. if the 
Ше was saved using CODE (or SCREENS. which is really just CODE 16384,6912) the 
word CODE will be printed followed by the start address and length that were specified when the 
file was saved 
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Here i$ а sample display resulting fom a CAT “t:" command, which may make this a little 
Clearer 


“simple " (BASIC) 
"execute " LINE 10 (BASIC) 
“numbers " DATA #0) 

"words " DATA c$() 

“mic " CODE 30000,12345 
"picture " CODE 16384,6912 


The lastitem was. in fact, saved usma. 
SAVE "picture" SCREENS 


Just lixe the other formsof CAT  itsoutputcan be directed ro a printer using stream. зе 





CAT #3,"t 


(Streams are explamed in par? 22 of this chapter ) Note that the above САТ 83," t : " command 
will not work unless a pnnter isconnected tothe +9 aridisonline Toabandon. press BREAK 


From the above it can be seen that if you have loaded (usma MERGE ""')a program contalmngan 
execution LINE parameter, the САТ "t:" display will identify that ime number for you You 
may then wish to save that program to disk using. 

SAVE filename LINE line number 


во that the disk version of that program runs ttsel{automatcally, 





itus the values for the CODE files that you will probably find most useful from the CAT "te"! 
display: Either note them down or punt them out Then rewind the tape so it is ги! before the header 
that has been read. Туре 





CLEAR start-! 


where startis the value printed for the startaddress Now type 


LOAD "" CODE 


When the file has loaded mto memory and the @ OK report appears the file can be saved to disx 


using. 





SAVE filename CODE start, length 
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This technique is only intended for transferring your own собе files (where you may have forgotten 
what start and length values were used when you seved them), Note that using this method to copy 
commercial software may be à breach of copynaht -chect: with the software author first 


There sre several reasons why this simple scheme may not work 


1 The code. when loaded would overwnte some of the system variables (in the range 23296 (5B00h) to 
23788 (SCCEh)), This upper address ті may vary - it is the value held m the system variable PROG 
(see part 25 of this chapter). 


2 Attempting to load code that has no header (or that ıs protected in some other way) probably wont 
even produce any output from CAT "tz" and you certainly wont be able 10 use the 
BASIC LOAD command to loadiit. 


3, If the code file is so long that и stretches right from the screen display ates to the end of memory, 
then it will be possible to load it, but as soon as it has loaded. the machine will crash. This 1s because 
BASIC will have lost its stack 


Exercise 


1 Prachse the operations shown m this зеспол until you are completely au fait with manipulating files 
toand from the disk, the RAMdisé. and cassette umt (if connected] 
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Part 21 
Printer operations 


Subjects covered... 


Parallel printers 
Serial printers 
LPRINT,LLIST 
FORMAT 

COPY 


The +3 comes with an 8 bit Centronics parallel port and an RS232 serial port. Both are supported by 
built-in software enabling you to use virtually any printer These features are usable only 
in +3 BASICmode 


The printer must have either a Centronics compatible (parallel) or an RS232 (serial) interface, and if 
you want to reproduce pictures of the screen. then the printer must have an Epson compatible 
quadruple-density bit- image araphics mode (ESC L п п). 


Make sure you have the correct lead to connect the pninter tothe 4-3 ifi doubt, consult your Sinclair 
dealet 


For further mformation about which printer and connecting lead to purchase. together with details cf 
the +3's PRINTER and RS232 socket connections see chapter 10 (Perpheralsfor your +3) 


Parallel printers 


When the +3 is first switched on it will assume that; fa printer is present 1t ул 
(parallel) PRINTER socket The hardware connecti 
straightforward - though you must make sure that you di 
computer end (ifthe cable doest t hi а key) 





i be connected to the 
between computer and printer ts relatively 
1 connect the cable the wrong way up atthe 











Once the connection has been made the command 


LPRINT "hello" 


should producesome printed output. Inot chees the odanecton ап 
septo online 





ге that your printer ip 





Once you have got your printer to pnnt: yau may: 





1p to the section ahead enniied Ceneral printing 
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Serial printers 


Unlike parallel printers, the connections between ће +3 and a serial (or RS232) printer will vary for 
different manufacturers printers Make sure that your dealer has provided a lead suitable ior 
connecting your particular printer to the +3 A senal printer must be connected to the +3'sRS232 
socket, and details of connections can be found in chapter 10 (Peripheralsfor your +3). 


The +3 always uses what is «own as hardware flow control, o: hardware handshaking, Ths means 
thatat will not transmit characters until certain control sionals from the printer have the right values It 
18 therefore very important that connections are made to the control lines of the +3 as well as the 
transmit and recerye data hnes И your printer does noi support hardware handshaking then connect 
pins 4 and 5 of the +3 s RS232 connector socket together. The drawback of not using hardware 
handshaking ts that the odd character may be lost when transmitting a lot ef data at highspeed. 


To get the +3 ond the printer communicating with each other they must both use the same baud 
rate The baud rate is the speed at which data ts transferred between computer and printer. Although 
Itis possible that your printer can be set to different baud rates. 111! probably be easier to change the 
rate at the com end Somewhere in the printers operating manual the Баша rate wil) be 
Speciied -And thisour and thensetthe +3 tothisrate. using the command 





FORMAT LINE baudrate 
Forexample 
FORMAT LINE 300 


(You wen t need tc do this if your printer normally uses 9600 band. asthe +3 will assume this rate by 
default) 
As the +3 usually expects to be operating with а parallel printer, t wil) be necessary to Ше the 
command 
FORMAT LPRINT "R" 

бейте ће +3 wil! successiully operate withs serial printer (The R in the above command is shart 
for К5232 } 
The commund tosetthe +3 ba 








paraliol (Centronics) mode is 


FORMAT LPRINT "С" 





"m 





General printing 


Once you have everything set up, уой сап use three BASIC commands to print things out. The first two. 
LPRINT and LLIST. are just ike PRINT and LIST excep! that they use the printer instead of 
the TV screen. Note that the Print option from +3 ВАЅІС edit menu has the same effect as 
LLIST. butisincluded ав ал easier method of getting а listing. 


Try this program for example: 


10 LPRINT "This program..."" 

20 LLIST 40 

30 LPRINT '"...prints out the 
character set, ie..."' 

40 FOR n=32 TO 255 

50 LPRINT CHR$ n; 

60 NEXT n 

70 LPRINT 


Its important to note that LPRINT апа LLIST normally take care to screen ош any embedaea 
colour codes (and their parameters) before primhino or lisung anything Embedded coleur codes are a 
bit of a hangover from the old 48K Spectrum -when included ina string they set INK, PAPER and sc 
on Prmters on the tend to use these codes for completely different things like setting italics 
underline etc зо и would be quite dangerous t Id colour codes to the printer and hope that 
nothing untoward happens. A side t of this 18 that the +3 will normally not be able te send 
escape control sequences to the printer For example suppose your printer expects an escape 
character (character 27) followed by "x"; CHRS(1) tc switch to ns NLO mode, you would 
normally use the comm 























LPRINT CHR$ (27);"x"; CHRS (1);" 
This is in Near Letter Quality" 


However, in +3 BASI 





FORMAT LPRINT "U" 














апа tel 


d chai 


odes. bur as ordi 








words »rtokens Likewise 





Ifyouvash уи сл 


FORMAT LPRINT 
+E 





aregountouse LLIST The +3 < 
da FORMAT LPRINT "U" сог 





xf is 


you want 











So, tosummanse. 


* Ifyou want to send special characters (such as ESC) to your printer (in order to use different styles: 
ofpnntind) issue the command. 


FORMAT LPRINT "U" 





before pnnting. 


* |f you are writing or modifying а program, and want to get a listing on the printer, issue the 
command., 


FORMAT LPRINT "E" 
before lisung the program. 


The third BASIC statement used with a punter - COPY. prints out a copy of the TV screen Tn 
demonstrate, go into the small screen (by selecting the Screen option from the edit menu) and 
type m the following command. 


FOR n=1 TO 20: PRINT n,: NEXT п 


The numbers 1 to 2C yall Бериле the top part of the screen. Now (уре 
COPY 


The COPY command taxes about 15-30 seconds to get started. sc dont panic if nothing appears to. 
happen immediately After a while, youll see a copy of the screen reproauced on the printer. (If all 
you get irom COPY is à iot of random characters on the printer then it's likely tat your printer isn't 
fully compatible ) 


‘You сап always stop printing at any time by pressing the BREAK key Many printers have what's 
гпомтаза buffer, which stores text before printing. If your printer has a buffer, then pressing BREAK 
will not stop the printer immediately (although ће +3 will register the break at once) 


Note that ii the COPY command Is stopped by pressing the BREAK кеу the printer may be ieftin 
graphics mode (this will be indicated by subsequent LPRINT statements producing a mass of 
meaningless dots. ot printing each are of text partly over the previous line) іп these circumstances. 
switching the printer off then on а the easiest Way ta jet thinas back to ^ 

















пе printer for each 
(COPY EXP) which 
opthescresn Tn 


As wellas the rather simple COPY com 
dot on the screen (whatever its colour 
prints differing combinat 
demonstrate: type tr the 


id. which just producesa 
be; 


13 


SS 


10 FOR b=@ TO 1 
20 BRIGHT b 

30 FOR i= TO 6 
LØ FOR с=@ TO 31 
50 PRINT INK i; i; 
60 NEXT c 

78 NEXT i 

80 NEXT b 


then switch to the bottom. part of the screen (usma the édit menu's Screen option). Run the 
program (which displays tweive lines of coloured numberson the screen), then type iñ. 


COPY EXP 





The prmtet output (or dump) from this command is shohirly larger than that from the standard COPY 
command - (EXP is short for expanded) The command reproduces the coloured areas of the screen 
as different densthes of black dots on the pnnter. (All 24 lines of the screen are reproduced.) Areas 
that have been printed with BRIGHT 1 will appear lighter than areas printed normally (justar 
happetison the screen) 





The drawback ol the COPY- EXP command is that it takes i longer ime fo print (about 10 minutas) 
but is ideally suited to dumpma старте pictures The quicker COPY command on the other hand, 
a better bet if you wish to dump text only, 





‘Ifthe screen display to be dumped is predaminantly black then n will nctonly wear eut your pratit 
ribbon rather quickly. but also wil) probably also take l jan а screen that has large 
meas of white Tr provent this the COPY EXP соп be followed by the word 
INVERSE te 








COPY EXP INVERSE 


As the command suggests. the dump is printed in INVERSE (ice а photographic neaanve) so that 
all the dark areasof the screen are printed-out light. and vice versa 


Note that INVERSE сало! be used affer the simple COPY command -1 only works with 
COPY EXP 


The dump produced by COPY EXP and COPY EXP INVERSE is designed to fit а sheet of 
M paper. however some printers will not print within about an inch at other end ofa sheet [this 
problem occurs, then itis possible to reduce the size of the dump slightly by asma the command. 


POKE 23419,8 


Thissetsthe number of 21 6thts mch used аз а line feed at the end of each pass of the printhead Tisser 
lo9 whenthe +3 isfust switched on Once set ity ifthe NEW commana is 
used. By reducing this value each pass of the pnnt hea overlay the previous pass As 
aconsequence. the quality of the dump reproduced will be degraded shahtly 
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—_————————————-—— 


Mf You try to use any of the printer commands when Їһетез<л! а pnnter attached (ог ће printer is off 
line), then the +3 val! stop dead while it panently warts for the (non-existent) pnnter to respond. In 
sucha case, pressing BREAK twice will bring ће +3 backtalie 


Try this 


10 FOR n=31 TO 0 STEP -1 

20 PRINT AT 31-n,n; CHRS ( COD 
E "Q"4n); 

30 NEXT n 


You will see a pattern of characters working down diagonally from the top right-hand corner until it 
reaches the bottom of the screen, at which point the program asks tf you want to scroll 


Now change AT 31-n,nin line 2010 ТАВ п The proaram will have exactly the same effect as 
before 


Now change PRINT тїтє 2010 LPRINT Thstime there will be no pause to scroll (this does ло! 
occur with the printer) 


Now change TAB п back to AT 31-n,n stil using LPRINT This time you will get just а 
single line of symbols. The reason for the difference 15 that the output from LPRINT is not printed 
straight away, buts stored isi the buffer until either one line's worth of printer output has accumulated, 
or something else Dushes the buffer Hence. printingonly takes place 

1 When the buffer rs full 

2 Afteran LPRINT statement that does not end ina comma or semicolon 

3 Whena comma apostrophe or TAB item requiresa new fine 

4 Atthe end ota program. it there isanything left urprinted 

5, When you set the printer off ine (this depends on your particular printer) 
Number 3 above explains why our program with TAB works the way it docs. As der АТ, the ime 


number 15 ignored. ard the LPRINT position (hke the PRINT posijon) is moved te the column 
number. An AT nem can never cause a hne to be sent to the printer 


Exercises 
|. Make a printed graph of à sine wave by running the first (3 hne) program in part 17 of this chapter. 
thenusma COPY 


9. Run the program àt the beqmnna nf part 16 of this chapter. and try botha COPY EXP. and à 
COPY EXP INVERSE 
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Part 22 
Streams 


Streams 
Channels 
FORMAT, OPEN, CLOSE 


The +3 can ‘read’ data from the keyboard by using INPUT and INKEYS, and it can write date 
onto the TV screen or a printer by using PRINT and LPRINT. However, these commends are 
really a form of shorthand designed to protect the user from some of the computer's more complex 
features. 


To the BASIC PRINT command. for example. the screen and the printer are ‘no different, 
PRINT "Rosanne" really means take the characters which make up the word ‘Rosanne’ and 
send them somewhere else’. It's just convement to use the screen most of the time, Likewise 
LPRINT usually sends data to the printer. In fact, what these commands really do is to send data ta 
oneofanumber of channels. 


A channel is the way in which the computer communicates with its input and output devices. There 
are three channels normally available to BASIC. These are. 


* Thescreen (called S) 
* The keyboard (called К) 
* ‘The printer (called P) 


Ofthese, the screens an output-only device, the keyboard is both an input and output device, and the 
printeris either an output-only device (if it uses the parallel PRINTER socket), or an input and output 
device (if it uses the serial RS232 socket) Outputting data to the keyboard might seem a funny idea 
but the computer uses the lower screen (hke INPUT does) to display the characters. 


To access a channel, it has to be open. Opening a channel makes it ready to receive or produce data. 
Achannelis opened by connecting it toa stream. From BASIC, you would use а command like. 


OPEN #4,"p" 


which means ‘connect stream 4 to the prmter channe! Streams are convenient ways for the 
computer to switch between channels by referring to them as numbers This idea makes possible to 
‘write programs that can send information to any device without having to use different commands, 
(Thisis known as redirectable (or device-independent) VO) 


This might seem over-complicated, and you may well wish to stick to the standard PRINT and 
LPRINT commands - thats why they're there, afterall. 
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PRINT and LPRINT are really the same command When BASIC is running, i! has three streams 
normally open. Stream #1 is connected to the keyboard device (K), and is used by INPUT and 
INKEYS. Stream #2 ts connected to the screen (5), and is used by PRINT and LIST Stream #3 
s connected to the printer (Р) andis used by LPRINT and LLIST Alof these commands can be 
redirected to use another device by including # followed by a current stream number, so, 


PRINT #1;"This is the lower screen" 


will print the message on the lower screen. Similarly. 
PRINT #3;"Who needs LPRINT, Gladys?" 
will use the printer. Conversely, LPR INT can behave like PRINT 
LPRINT #2;"Confusing, or what?" 


behaves justasifthe LPRINT #2werePRINT 


As they stand, these examples are fairly useless but serve to demonstrate а point. This sort of thing 
becomes useful if you want to write а program where the results might go either to the printer or the 
Screen, like so. 


10 REM squares program for pri 
nter 

20 INPUT "do you want to print 
the results?";a$ 

30 LET stream=2 

40 IF a$-"y" OR a$=" 
T stream=3 

50 FOR п=0 TO 10 

60 PRINT #stream;n,n*n 

70 NEXT n 


The +3 can cope with 16 streams As 3 are used by BASIC, and 1 ts used internally, this leaves you 
with 12 You can use these by. 





" THEN LE 


10 REM program to read data fr 
om RS232 

20 FORMAT LINE 9600 

30 FORMAT LPRINT "г" 

40 OPEN #4,"p" 

50 PRINT INKEYS #4; 

60 GO TO 50 


which takes characters in from the RS232 mterface and prints them onto the screen. 
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Ifyou want to read m data from the RS232 mto memory directly, you can replace line 50 wath. 
POKE address, CODE (INKEYS #4) 


As ме mentioned before, the screen and the parallel PRINTER socket can only be used Љу the 
+3 for output, They cannot be used for input. and if you try PRINT INKEYS #2, for example 
you'll receive an error report, 


Itis theoretically possible to redirect BASIC's normal output streams, so by using. 


18 CLOSE #2 
20 OPEN #2,"p" 


all the PRINT output will go to the printer instead of the screen ( you try to do this durifig editing 
the results will be unpredictable. so's best leftalone ) 


On the standard +3 system, streams and channels are of mostly academic interest’ However 
certam peripherals and BASIC language extensions do use the stream system lor more compley 
functions, 
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Part 23 
INand OUT 


IN 
OUT 


The processor can read from (ROM and RAM) and write to (RAM) memory by using PEEK and 
POKE. The processor itself does not really care whether memory 1s ROM or RAM - it just thinks that 
there are 65536 memory addresses, and it can read a byte from each one (even if i's nonsense), and 
write a byte to each one (even if it gets lost). In а completely analogous way, there are 68536 of what. 
are called YO ports (standing for input/output ports) These are used by the processor for 
communicating with things hke the keyboard or the printer, and also for controlling the extra memory 
and the sound chip. Some of them can be safely controlled from BASIC by using the IN function and 
the OUT command, but there are locations to which you must not write from BASIC as you will 
probably cause the system to crash, losingany program and data. 


INusafunchon like PEEK. Its formis 
INaddress 


Ithas one argument- the port address, and its resultisa byte read from that port. 
OUT isastatementlike POKE Its formis. 


OUT address , value. 


„which writes the given value to ће port with the given address. How the address is interpreted 
depends Very much upon the rest of the computer. Quite often, many different addresses will mean 
the same On ће +3 itis most sensible to imagine the address being written in binary, because the 
individual bits (each of which can have the value either 0 or 1) tend to work independently There are 
16 bits, which we shall refer to (using A for address) as. 


А15, A14, A13, A12, ALL А10 А9, AB, АТ, Аб, А5, A4, A3, A2, Al, Ай 


Here, A0 is ће 15 bit, Al is the 2s bit, A2 1s the 4s bit, and so on. Bits AQ, Al, A2, АЗ and A4 are the 
important ones. They are normally 1, but if any one of them is 0, then this tells the computer to do 
something specific The computer cannot cope with more than one thing at a time, so по more than 
one of these five bits should be 0 Bits A6 and A7 are ignored, so if you are a wizard with electronics 
you can use them yourself The best addresses to use are those that are | less than a multiple of 32, so 
that AO to A4 are all 1. Bits А8, A9, and so on are sometimes used to give extra iniormation, but mostly 
for the extra memory and sound. 
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‘The byte being written or read has8 bits, and theseare often referred to (using D for data) as... 
‘D7, D6, DS, Ds, D3, D2, Dl. DO 

Here followsa list of the port addresses used. 

‘There isa set of input addresses that read the keyboard and the tape Interface. 

The keyboard is divided up into8 half-rowsof5 keys each. viz 


IN 65278 (FFFEh)  resdsthehaltrow CAPSSHIFT to V 
IN 65822 (PDFEh) readsthehalf-rowAtoG 

IN 64510 (FBFEh) readsthehal-row Qto T 

IN 63486 (FIFEh) readsthehalt-row 1165 (and JOYSTICK 2) 
IN 61438 (EFFEh) readsthe half-row Ø tc 6 (and JOYSTICK 1) 
IN 57342 (DFFEh) readsthe hall-row Pto Y 

IN 49150 (BPFEh) readsthe hali-row ENTER io H 

IN 32766 (ТЕРЕ) readsthe half-row (space)toB 


(These addresses are 254+256x(255-2 | n)asn goes from tc 7.) 


Remember that digits followed by А sigmfy hexadecimal numbers. If you don't understand these, 
refer to part 320f his chapter 


In the byte read in. bits DO to D4 stand for the five Keys in the given half-row. 7015 for the outside key, 
and D4 is for the one nearest the middle. The bit is 0 if the key 1s pressed. 1 if it 1s not. D6 1s set by the 
tape interface, and Is effectively random if no tape data ts present. 


For JOYSTICK 1, bit Ois fire, bit ] is up, bit 218 down. bit 315 nchr and bit 4 is left For JOYSTICK 2, bit 0 
is left, bit | is right. bit 2 1s down, bit 31s up and bit 41s fire. From BASIC. these read as the number 
keys 


Port address 00FEh (254 decimal] im output drives the sound (D4) and the save signal to the tape 
interface (03) and also sets the border colour (D2, D! and DO) 


Port addresses 00FEh (254), OOF 7h (247) and OOEFh (239) are reserved 


Port address 7FFDh (32765) drives the extra memory Executing an OUT to this port trom BASIC will. 
nearly always cause the computer to crash. losing any program and data. There isa fuller description 
ofthis port in part 24 of tis chapter (under the heading Memory management ) This port is write oriy, 
Je. you cannot determine the current state of the paging by an IN mstructon Thisis why the BANKM 
system variable is always kept up to date with the last value output to this port. 


Port address BFPDh (49149) drives the sound chip's data registers. Port address FFFDh (69533) in 
output writes a register address, and in input readsa register judicious use of these two registers сап 
allow sounds to be generated whilst BASIC gets on with something else. but you should be aware that 
they also control RS232/MIDI and AUX interfaces 


Port address OF FDh (4093) ts used for the parallel (Centronics) interface he PRINTER) When read 
using an IN mstrichon bit 6 shows the state of the BUSY sonal produced by the printer. If the printer 
is off hne or non-existent. then this bit will be | When this port is written to asina OUT. 1t acts as the 
parallel port data register. Inorder to print а character itis necessary to want unt! BUSY 1s 0, ите the 
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character code to port OFFDh (4093), and finally, take the STROBE bit in port IF FDh (8189) low then 
back highagain. 


Port address IFPDh (8189) controls several aspects of the +3. Amongst other things, this port 
controls the ROM that is switched into the memory area from 0000h.. 3FFFh (0... 16383). As the portis 
wnteonly, +3 BASIC maintains a variable, BANK678, that holds the value last output to this port, Itis 
therefore very unwise to OUT values directly to this port without first checking on the current state 
and sethng/resetting only the bits you are interested їп. This is also the case for the port at ZPFDh 
(which holds its current state in BANKM). The bottom three bits (0...2) of this port (1FFDh) are used to 
switch RAM/ROM - further details can be found in part 24 of this chapter (under the heading Memory 
management). Bit 3 controls the disk motor (0 is off, | is on), though it should not be necessary to 
control the motor by wnting to this port as there are +3DOS routines that will achieve the desired 
effect, Bit 4 is the parallel port STROBE which is active low -this means that to print the character that 
has been output to port OF Dh (4093), the STROBE bit should be brought low and then returned to its 
normally high state, 


Port address 2FFDh (12285) сап be used to read the disk controller (uPD765A) chip's main status 
register, This is unlikely to be very useful without an in-depth knowledge of how the chip operates. 


Port address 3FFDh (16381) is the disk controller's data register. This can be both read from and 
written to, but once again it is unlikely to be useful to the BASIC programmer Random QUT putting to 
this port will probably confuse the poor disk controller chip to such an extent that subsequent disk 
operations (like LOAD and SAVE) will be unreliable. It is entirely possible that ill-informed 
experiments will corrupt your disks and lose your data - you have been warned! 


Run this program to see how the keyboard works. 


10 FOR п=0 TO 7: REM half-row 
number 

20 LET a-2544256*(255-21n) 

30 PRINT AT 20,0; IN a: GO TO 
30 


and play around by pressing keys (start with the half-row from CAPS SHIFT to V). When you 
finished with each half-row. press BREAK and then type. 


NEXT n 


The control, data and address busses are all exposed at the back ofthe +3 сп the EXPANSION I/O 
socket. This means that you can do almost anything witha +9 that you could with а raw 280 chip 
(although sometimes; the computer's internal workings may get in the way). 


See chapter 10 fora diagram and pin-out ofthe EXPANSION I/O socket 
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Part 24 
The memory 


Subjects covered... 


PEEK 
POKE 
CLEAR 
Memory management 


Deep inside ће 4-3, everything is stored аз bytes, ie. numbers between 0 and 285 (FFh). You may 
think you have stored away the price of Ruddlesor the players names in the Arsenal football team, but 
їп fact, all the information has been converted into collections of bytes, and bytes are what the 
computer sees. 


Each place where a byte can be storéd has an address. which is а number between 0 (от 0000h) and 
65535 (FFFFh) This means that sn address can be stored as wo bytes Youcan think of the memory ағ 
a long row of numbered boxes, each of which can contain а byte Not all the boxes are the same, 
however - the boxes from 4000h to FFFFh are RAM boxes, which means you can open the lid and alter 
{he contents, but those from 0 to 3FFFh are ROM boxes, which have a glass lid that cannot be opened 
»you just have to read whatever was put info them when the computer was made Inthe +3, we have 
crammed in more than twice the amount of memory than can comfortably fit. While the processor can 
address 65536 bytes. there are in fact 131072 bytes of RAM and 65536 bytes of ROM making 196608 
bytes (192K) in all! All thisis hidden from the processor by the hardware using a processcalled paging 

BASIC (and the processor) always sees the memory as 16K of ROM and 48K of RAM (or 64K of RAM 
within ROM - though this latter combimanon в never used by BASIC). 


65535 FFFFh 
49152 [| Co00h 
32168 | =: 8000h 
чш 

oen 


The +3 memory map 
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To inspect the contents of а box. we use the PEEK function. Its argument is the address of the box. 
and its result is the contents. For example, this program prints out the first 21 bytes in ROM (and their 
addresses)... 


10 PRINT "Address"; TAB 8; "By 
te" 

20 FOR а=0 TO 20 

30 PRINT a; TAB 8; PEEK a 

40 NEXT a 


All these bytes will probably be quite meaningless to you, but the processor chip understands them to, 
be instructions telling it what to do. 


To change the contents of a box (111115 RAM), we use the POKE command. Its form is. 
POKE address , contents 


where address and contents are numénc expressions For example, її you type. 


POKE 31000,57 
then the byteat address 3100015 given the new value 57. Now type 


PRINT PEEK 31000 


to prove this. (Try poking m other values, to show that there 1s no cheating.) The new value must be 
between -255 and *258, if! is negative, then 2561s added toit. 


The ability to poke gives you immense power over the computer if you know how to wield it and 
immense destructive possibilities if you don't. It is very easy (by poking the wrong value into the 
wrong address) to lose vast programs that took you hours to type in Fortunately though, you won't do 
the computer any permanent damage. 


We shall now take a more detailed look at how the RAM is used. Don't bother to read this unless you're 
really interested. 


The memory is divided into different areas (shown їп the diagram ahead) for storing different kinds of 
information. The areas are only large enough for the information that they actually contain, and ìf you 
insert some more at a given point (for instance by adding a program line or variable), then space is 
made by shifting up everything sbove that point Conversely, if you delete information, then 
everythingisshifted down 


‘The display file stores the contents of the TV screen. It is rather cunously laid out, so you probably 
won't want to PEEK or POKE init Each character positon on the screen has an 8 x 8 grid of dots; 
each dot can be either 0 (paper) or | (ink), so by using binary notation we can store the pattern as 8 
bytes-one for each row. However. these 8 bytesare not stored together. The corresponding columns 
in the 32 characters of a single line are stored together asa scan of 32 bytes, because this ts what ће 
electron beam їп ће TV needs as it scans from the left-hand side of the screen to the other: Since the 
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complete picture has 24 lines of 8 scans each, you might expect the total of 192 scans to be stored in 
order, one after the other - well, you'd be wrong! First come the top scans of lines 0 to 7, then the next 
scans of lines 0 to 7, and so on to the bottom scans of lines 0 to 7; then the same for lines 8 to 15; and 
again for lines 16 to 23. The upshot of all this is that if youre used to a computer that uses PEEK and 
POKE on the screen, then you'll have to start usmg SCREENS and PRINT AT instead (or 
PLOT and POINT) 


‘The attnbutes are the colours and so on for each character position, using the format of A T TR. These 
are stored line by line in the order you'd expect. 


The way that the computer organises its affairs changes slightly between 48 BASIC and +3 BASIC 
mode, The area that was the printer buffer in 48 BASIC mode, is used for extra system variablesin +3 


BASIC mode in much the same way as it was on the Spectrum +2 The variables have changed, 
though. 


5000h 
23352, 


{ 





асыры 


1 1 
1 D 








WORKSP 5ТКВОТ STKEND ЗР EAM UDG АМТ 
(STACK POINTER) ТОР 


BASICmemory map 
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The system variables contam various pieces of mformation that tell the computer what sort of state it's 
in, They are listed fully in part 25 of this chapter, but for the moment, note that there are some (called 
CHANS, PROG. VARS, E LINE. and so on) that contain the addresses of the boundanes between the 
various areas in memory. These аге not BASIC vanables. and thew names will not be recognised by 
the +3, 


The channel information contains information about the mput and output devices, namely the 
keyboard (together with the lower half of the screen). the upper half of the screen, and the printer. 


Each line of BASIC program has the form 


Most significant byte 
Least significant byte 


| 


КІ 


oo ne a oe 


Line Lengthof 
number text + ENTER 





Note that, m contrast with all other cases of two-byte numbers m the 280, the line number here 15 
stored with its most Significant byte first. е in the order that youd wnte them down 


A numerical constant int the program is followed by its binary form. using the character CHRS 14 
followed by five bytes for the number itself 


The variables have different formats according to their different natures. The letters in the names 
should beimagimed as starting off m lower case 


Number whose name sone letter only 





Sign bit 
4 
шш "| жшн 
puer 
Letter-60h Value 
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Number whose name is longer than one letter 





Letter-60h 2nd character Last character Value 
Array of numbers: 
Je 
lc esie n 
Letter 60h Тоа No.of  lstdim lastim. Elements 


dims 





of dimensions 


Theorder ofthe elementis 


First - the elements for which the first subscriptis | 

Next - the elements for which the first subscript i52 

Next ће elements for which the first subscripl i53. 
and so on for all possible values of the first subscript 


The elements witha given first subscript are ordered in the same way using the second subscript, and 
зо оп down tothe last, 


As an example, the elements of the 3 x 6 апау c in part 12 of this chapter are stored in the order 
(1,1) с(1,2) с(1,3) с(1,4) с(1,5) с(1,6) and 
c(2,1) c(2,2) с(2,6) апіс(3,1) с(3,2) с(3,6) 
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Control variable ofa F OR. NEXT loop: 


Leastsignificant byte — Mostsignificant byte 


id 
I-II 


Letter-60h Value Step Looping Statement 
number 
within line 


String: 
Latter-60h Number of Text of string (may beempty) 
characters 
Array of characters. 


тев 
a - J 


lastdm Elements 











dims + 
of dimensions 


The calculator is ће part of the BASIC system that deals with anthmetic, and the numbers on which it 


isoperating are held mostly in the calculator stack 
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Тһе spare area contains the space so far unused. 
The machine stack ts the stack used by ће Z80 processor to hold return addresses and soon. 
TheGO SUB stack wasmennoned in partSofthischapter 


The byte pointed to’ by RAMTOP has the highest address used by the BASIC system. Even NEW 
which clears the RAM, only does so as jar as this - so it doesnt change the user-defined graphics You 
can change the address RAMTOP by putting a number ina C LE AR statement, e. 


CLEAR new RAMTOP 


» Which does the following 
|, Clears outall the variables 
2 Clears the display file (like CL$ does) 
3 Resetsthe PLOT positon tothe bottom left hand corner 
4 RESTOREsthe DATA pointer. 


5 Clearsthe GO SUB stackand putsitatthe new RAMTOP (assuming that this lies between 
the calculator and the physical end of RAM. otherwise it leaves RAMTOP where it was) 


RUN also performsa CLEAR, although it never chances RAMTOP. 


Using CLEAR in this way, you can either move RAMTOP up to make more room for thè BASIC by 
‘overwriting the user-defined graphics, or you can move it down to make more RAM that is preserved 
from NEM. |! can also be used to ensure that the machine stack is below BFEOh (49120) when 
intending to call +3005 - this means that the stack will not have ta be subsequently moved within your 
own machine code 


If you are m an experimental frame of mind you can also use CLEAR to explore the extra memory. 
CLEAR 49151 moves all of BASIC below the addresses that hold the switchable RAM paging. 
By using POKE 23388, 16+п where nisa number between 0 and 7, you can make the computer 
switch in page п of the КАМ. You will then be able to use PEEK and POKE in the normal way to 
examine and change the раде Beware - the extra paces are normally used by the system for disk and 
editor operations, soalwaysresetthe +3 after explonngin this way, before doing anything else 


Type NEW, select +3 BASIC then enter the command CLEAR 23825 to get some idea of 
what happens to the machine when tt fills up. 


If you then try to make the +3 compute; (for example type m PRINT 1+1) you will see the 
report 4 Out of memory displayed This means the computer has no more room for 
information. If you come up agamst this message while enteritia a large program. you will have to 
empty the memory slightly (delete a Ime or so) i order to.centro! the commuter 
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Memory management 


We mentioned earlier that there 1s rather more memory in the computer than the processor can deal 
with, While the processor can indeed address only 64K of memory at once, the extra memory can be 
slotted in and out of that 64K at will Consider a TV set. Although it (and you) can only deal with one 
channel at a time. there are another three channels always there which can be selected with the night 
buttons: So, even though there's four times аз much information as you can use at any one time, you сал. 
pickand choose which partis relevant. 


It is much the same for the processor. By setting the nght bits in an VO port it can pick and choose 
which chunks of the 192K of memory it wants to use, For the majonty of the time in BASIC it ignores 
most of the memory, but for games playing, having three times as much RAM is really rather useful, 
Lookagain atthe +3's memory map (shown at the beginning of this section), RAM pages? and З are 
always m the posihons shown when BASIC is used. though there's no reason why they shouldn't bein 
the banked section (C000h to FFF Fh) - however, 1t would be difficult to see any use for this 


The RAM banks are of two types. RAM pages 4 to 7 which are contended (meaning that they share 
nme with the video circuitry). and RAM pages 0 to 3 which are uncontended (where the processor has 
exclusive use) Any machine code which has critica! timing loops (such as music or communications 
programs) should keep all such routines in the uncontended banks. For example, executing NOPsin 
contended RAM will give an effective clock frequency of 2. 66MHz as opposed to the normal 3.55MHz. 
müncontended RAM Thisisa reduction in speed of about 25% 


The hardware switch normally used to select RAM is at l/O address TFFDh (32765), The bit field for 
thisadáress sas follows. 


DOLDA -RAMselect 


рз -Screen select 
D4 -ROM select 
D5 - Disable paging 


D2. DO is а three bit number that selects which RAM page goes into the C000h to FFFFh slòt, In 
BASIC, RAM page Qis normally in situ. When editing or calling 4-3DOS routines, RAM page 7 is used 
for various buffers and ‘seratchpads D3 switches screens. screen Ois held in RAM page 5 (normally 
beginning at 4000h) and ts the one that BASIC uses Screen | is held in RAM 7 (beginning at C000h) 
and can only be used by machine code programs It is entirely feasible to set up a screen m RAM 7 
and then page ir out; this leaves the entire 48K free for data and program, Note that the +95 COPY 
(file) command may well use buffers in the second screen area (corrupting a second screen which 
may be hidden there) D4 determmes which ROM is paged mto 0000h to 3FFFh (in combination with 
bit 2of port !FFDh- see below) 05 1 a safety feature - once this bit has been set, no further paging 
‘operations will work. This is normally used when the the machine assumes а standard 48K Spectrum 
configuration and all the memory paging circuitry is locked ош It cannot be turned back into a 128K 
machine other than by switching ОЁ or pressing the RESET button, however, the sound chip can stil 
bedriven by OUT ifa 48K Spectrum game loaded from disk will not work itis possible that by using 
the SPECTRUM command followed by OUT 32765 „48 (which locks bit 5 m this port) the 
game maght then work 
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The +3 also uses ИО port |FFDh for зоте ROM and RAM switching, The bit field for this address is 
asfollows: 


DO0.DI -ROM/RAMswitching 


Da - Affects whether DO...Dl workon RAM/ROM 
D3 - Disk motor 
D4 - Parallel port strobe (active low) 


When bit 0150, bit I has no effect and bit 2 1s vertical’ ROM switch (iè between ROM 0 and ROM 2. 
or between ROM ! and ROM 3). Bit 4 in the port at TFFDh is a "honzonta! ROM switch (ie. between 
ROMO ала ROM |, ot between ROM 2 and ROM 3) The following diagram serves to show the various 
ROM switching possibilities. 


Bit4 7FFDh (23388) 
ROM 0 (system variable: BANKM) 
Editor — horizontal — 
D T 


Bit2 1FFDh (23399) 
(system variable: BANK678) 
vertical vertical 


| 1 
ROM 2 ROM 3 
bog | deal — | „м 


Hotizorital and vertical ROM switching 


{tis best to think of bit 4 in port ZFFDh and bit 21m port IFFDh combining to form a 2 bit number (0...3) 
which determines which ROM occupies the memory area 0000h. 3FFFh Bit 4 о! port ZFFDhis the 
least significant bit and bit 2 of IFFDhis the most significant bit: 





190 


Bit2of IFFDh Bit 4of TFFDh 
(System variable:BANK678) | (Systemvariable:BANKM) | Switched ROMat0000h...3FFFh 





100) 





ing (with Bit Oof 





ROMs 
various RAM combinations that occupy the 
BASIC but are provided for authors of operating 
пе 15 used, the bootstrap is loaded into the 4, 7, 6. 
tions аге as follows: 











ыыр IFFDhis set to 1, bits | and 2 switch 
S ‘DOS BOOT rout 
nous +3 extra RAM pai 














ће to 
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Part 25 
The system variables 


Subjects covered... 
POKE, PEEK 


The bytes in memory from SBO0h (23296) to SCB6h (23734) are set aside for specific uses by the 
‘system, There are a few routines (used to keep the paging in order). and some locations called system 
variables. You can peek these to find out vanous things about the system. and some of them can be 
usefully poked. They are listed here with their uses. 


There 1з quite а difference, as you might expect, between the system variables area in 48 BASIC 
mode andin +3 BASIC mode. In 48 BASIC mode. all the variables and routines below 5000h (23552) 
do not exist; instead there is a buffer between 5B00h (23296) and 5C00h (23552) which is used for 
controlling the printer This was quite a popular location for small machine code routines on the old 
48K Spectrum, and if any of these rounnes are tned tr. +3 BASIC mode, the computer will invariably 
crash. Any old program that uses PEEK, POKE and USR ss therefore a safer bet ifit is run in 48 
BASIC mode (although it can be entered in +3 BASIC mode and transferred using the 
SPECTRUM command) If there isa chance that a program might inadvertently address the added 
VO ports of the +3, then OUT 32765 , 48 will set bit 5 in port TFFDh to disable further use of the 
added ROM/RAM switching, 


Although system vanables have names, you should not confuse them with the words and names used 
1n BASIC. The computer will not recognise the names as referring to system vanables; they are given 
solely asmnemomics for we humans. 

The abbreviations in column | of the table ahead have the following meanings 

X-The variables should по! be poked because the system might crash. 

М - Poking the vanables will have no lasting effect 

R-Routine entry point. Nota variable. 

The number m column | is the number of bytesin the vanabie or routine. For a two-byte word, the first 
byte ts the least significant - the reverse of what you might expect. So. to poke à value v mto à two-byte: 
variable at address п, use. 


POKE n,v-256* INT (v/256) 
POKE n*1, INT (v/256) 


,andto peek its value, use the expression... 


PRINT PEEK n*256* PEEK (n*1) 
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NOTES (DECIMAL) NAME CONTENTS 

RIE 5В00һ (23296) SWAP Paging subroutine. 

RIT 5В10һ (23312) STOO Paging subroutine. Entered with mterrupts 
already disabled and AF, BConthestack 

RO 5В21һ (23329) YOUNGER Paging subroutine. 

RIG SB2Ah (23338) REGNUOY Paging subroutine. 

R24 SB3Ah (23354) ONERR Paging subroutine, 

xa 5B52h (23378) OLDHL Temporary register storé while switching 
ROMs. 

xi 5В541 (23380) OLDBC Temporary register store while switching 
ROMs. 

x2 5856 (23382) OLDAF Temporary register store while switching 
ROMs. 

N2 5В88һ (23384) TARGET Subroutine address in КОМЗ. 

x2 ‘5BSAh (23386) RETADDR Return address in ROM |. 

xl SB5Ch (23388) BANKM Copy of last byte output to VO port 7FFDh 


(32765). This portis used to control the RAM 
paging (bits 0..2), the "honzontal ROM 
switch (0—1 and 2-—+3 - bit 4), screen 
selection (bit 3) and added VO disabling 
fbit 8). This byte must be kept up to date 
with the last value output to the port if 


interrupts are enabled. 

xi SBSDh (23389) RAMRST RST 8 instruction. Used by ROM 1 to report 
old errorsto КОМЗ. 

NI SBSEh (23390) RAMERR Error number passed from ROM | to ROM 
3 Also used by SAVE/LOAD as 
Temporary drive store. 

2 SBSFh (23381) BAUD RS232 bit penod m T states/26, Se! by 
FORMAT LINE 

Na 5B61h(23393) SERFL Second-character-received-flag, and data. 

NI SB63h (23395) COL ‘Current column from ! to width, 

1 5B64h (23396) WIDTH Paper column width. Defaults to 80. 

1 5B65h (23397) TVPARS Number of inline parameters expected by 
В5232 

| 5B66h (23398) FLAGS3 Various flags В150, |, 6and 7unhkely to be 


useful. Bit 2 15 set when tokens are to be 
expanded on pnnting, Bit 3 is set if pnnt 
output is RS232. The default (at reset) is 
Centronics, Bit 4 is set i a disk interface 1s 
present. Bit 51взе!\їйпүе В ispresent. 















‘ADDRESS HEX 
NOTES (DECIMAL) NAME CONTENTS 
Xl 5В67 (23399) BANK678 Copy of last byte output to VO port IFFDh 
(8189) This port is used to control the +3 
extended RAM and ROM switching (bits 
0.2 - ¢ bit 0 ts D then by 2 controls the 
verhca! ROM switch 0-—+2 and 1—53) 
the disk motor (bit 3) and Centronics strobe 
(bit 4) This byte must be kept up to date 
with the Jast value output to the port if 
interrupts are enabled 
NI 3B68h (23400) хос Holds X locanon when using ће 
unexpanded COPY command 
NI 5В69һ (23401) ос Holds Y location when using the 
unexpanded COP Y command. 
x SBBAN (43402) OLDSP Old SP (stack pomter) when TSTACK in 
usc 
Xe, SBECh (73404) SYNRET Return address for ONERR 
8 BBSEh (23406) LASTV Lastvalue pnnted by cslculator. 
2 5B73h (23411) RCLINE Current пле being renumbered 
2 5B75h (23413) RCSTART Staring ime number for renumbering. The 
default value ıs 10. 
2 5BTTh (23415) RCSTEP Incremental value for renumbering, The 
defeultas 10 
\ SB7Gh (23417) LODDRV Нов T i£ LOAD. VERIFY MERGE are 
from tape otherwise holds A. B or M 
| BB? Ah (23418) SAVDRV Holds T f SAVE isto tape. otherwise holds 
A BoM 
| 5B7Bh (23419) DUMPLF Hcids the number of 1/216ths used for ling 
COPY EXP Thisis normally set 
тобел are experienced {itung 4 
onto à sheet of A4 paper POKE this 
ол with & This will reduce the size of 
е їр and improve the aspect ratie 
slightly (The quality of the dump will be 
marginally degraded. however ) 
NU SB/Ch (23420) STRIP! Утре one bitmap: 
№ 5B84h (23428) STRIP2 Stipe two bitmap, This extonds to Bl 
(23436), 
xus 5ВГГһ (23551) TSTACK Tempotary stack grows down from here 








(4s switched in at 
ng the editor 
go down try 
SB8Ch (and across STRIP) and STRIP? ii 
necessary) This quardatees а! least 115 
bytesofstack when BASIC calls -3DOS 
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ADDRESS HEX 

NOTES (DECIMAL) NAME CONTENTS 

NG 5C00h (23352) KSTATE Used in reading the keyboard 

NI 5C08h (23560) LASTK Stores newly pressed key. 

1 5С09!! (23561) REPDEL Time (in 50ths of а second) that a key must 
be heid down before it repeats. This starts 
offat 35, but youcan POKE mother values 

| SCOAh (23562) REPPER Delay (m $0ths of a second) between 
Successive repeats of a key held down 
aninally 5 

Na SCOBh (23563) DEFADD Address of arguments of user defined function 
1&олезз being evaluated), otherwise 0. 

Nt 5СОП (23965) KDATA Stores 2nd byte of colour controls entered 
from keyboard. 

Na SCOEh (23566) ТУРАТА Stores bytes of colour, AT and ТАВ 
contralsgoingto TV. 

X38 5C1Ch (23568) STRMS Addressesof channels attached to streams 

2 5СЗ3ёһ (23606) CHARS 286 jess than address of character set 
(which starts with space and carnes on to 
©) Normally їп ROM. but you can set up 
your own in RAM and make CHARS point to 
t 

І 5C38h (23608) RASP Length of warning buzz 

і ЭСЗӘһ (23608) PIP Lengthof keyboard click 

1 5C3Ah (23610) ERRNR 1 less than the report code. Starts off at 288 
(01-1) 50 PEEK 23610 mves255 

Х! 5C3Bh (23611) FLAGS Various flags to control the BASIC system 

XI 5C3Ch (23612) TVFLAG Flagsasscciated with the TV 

x §C3Dh (23613) ERRSP Address of item on machine stack to be 
used аз error return 

Na SCIFh (23615) LISTSP Address of return address from automatic 
lista, 

NI ЗСА} (23617) MODE Specifies K. L, С. Eor G cursor 

2 SCA2h (23618) NEWPPC lane to be jumped to. 

1 5С44һ (23620) NSPPC ‘Statement number in line to be jumped to 
Poking first NEWPPC and then NSPPC 
forces a jump to а specified statement in а 
tine. 

$ 5С45һ (23621) PPC Line number of statement currently being 
executed. 

! ЗСАТЬ (23623) SUBPPC Number within ile of statement being 
executed 

i 5СА8һ (23624) BORDCR Border colour multiplied by 8, also contains 
fhe attributes normally iad for the lower 
halfofthescreen. 

a 5СА9һ (23625) EPPC Number of current fine (with program 
cursor), 











NOTES (DECIMAL) NAME CONTENTS. 

х2 5C4Bh (23627) VARS Adáressol variables 

Nà SCADh (23629) DEST Addressof vanablein assignment. 

х2 BCAFh (23631) CHANS Addressof channel data. 

xa 5051h (23633) CURCHL Address of informabon currently being 
used for input and output 

Xe 5С53һ (23635) PROG Address of BASIC program. 

xa 5С55һ (23637) NXTLIN Address of next line in program. 

x2 5CSTh (23639) DATADD Address of terminator of last DAT A item. 

х2 SCS9h (23641) ELINE Addresscfcommand being typed in. 

2 SCSBh (23643) KCUR Addressofcursor 

ха §CSDh (23645) CHADD Address of the next character to be 
interpreted - the character after the 
argument of PEEK, or the NEWLINE at the 
endofa POKE statement. 

2 SCSFh (23647) XPTR Address ofthe character after the Wi 
marker. 

Ха 5C81h (23649) WORKSP Address of temporary work space. 

xa 8C63h (23651) STKBOT Addressof bottom of calculator stack. 

х2 SC6Sh (23653) STKEND Address of start of spare space, 

NI SC67h (23685) BREG Calculator s Bregister. 

Na SC68h (23686) MEM Address of area used for calculators 
memory (usually MEMBOT, but not 
always) 

1 BCBAh (23658) FLAGS2 More flags. (Bit 3 set when CAPS SHIFT or 
CAPSLOCK son ) 

х 5C6Bh (23659) DPSZ The number of lines (including one blank 
line) in the lower part ofthe screen. 

a 8C6Ch (23660) STOP The number of the top program line: iv 
automatic listings. 

a 8C8Eh (23662) OLDPPC line number to which CONTINUE 
jumps. 

1 SCTOh (23664) OSPCC Number within line of statement to which 
CONTINUE jumps 

NI ВСТ1һ (23663) FLAOX Various flags 

N2 5072h (23666) STRLEN Length of string type destination in 
assignment. 

№ 5С14һ (23668) TADDR Address of next item in syntax table (very 
unlikely to be useful) 

2 5C76h (23670) SEED The seed for RND. This is the variable that 
issetby RANDOMIZE 

3 5C78h (23672) FRAMES 3 byte (least significant byte first), frame 
counter incremented every 20mS. 

Н BCTBh (23675) UDG Address of first user-defined graphic. You 
can change this, for instance, to save space 
by having fewer user-defined graphics, 





ADDRESS HEX 





NOTES (DECIMAL) NAME CONTENTS 

| SCTDh (23677) COORDS X-coordinate of last pont plotted, 

1 ЭСТЕП (23678) Ү-соогйша!е of last point plotted. 

и 5C7Fh (23679) PPOSN 33-column number of printer position, 

1 5C80h (23680) PRCC Least significant byte of address of next 
position for LPRINT to pnnt.at (in pnnter 
buffer), 

1 5C81h (23681) Notused. 

2 5C82h (23682) ECHOE 33-column number and 24-line number (in 
lower half) of end of input buffer. 

2 SC84h (23684) DFGC Address in display file of PR LN T position. 

2 SC86h (23686) DFCCL Like DF CC fot lower part of screen. 

XI ‘SC88h (23688) SPOSN 33-column number for PRINT position. 

Xl 5C89h (23689) 24-line number for PRINT position. 

x2 SC8Ah (23690) SPOSNL Like SPOSN for lower part. 

1 5C8Ch (23692) SCRCT Counts scrolls - it is always | more than the 
number of scrolls that will be done before 
stopping with scroll?. If you keep 
poking this with a number bigger than | 
(say 255), the screen will scroll on and on 
without asking you 

1 §C8Dh (23893) ATTRP Permanent current colours, etc., (as set up. 
by colour statements), 

1 SC8Eh (23694) MASK P Used for transparent colours etc. Any bit 
that ıs 1 shows that the corresponding 
attribute bit is taken not from ATTR Р, but 
from whats already on the screen. 

NI БСР (23695) ATTRT Temporary current colours, ètc., (аз set up: 
by colour items). 

NI 5C90h (23696) MASKT Like MASK P, but temporary. 

1 SC91h (23697) PPLAG More flags. 

N30 SC92h (23698) MEMBOT Calculators memory area - used to store 
numbers that cannot conveniently be put on 
the calculator stack. 

a SCBOh (23728) NMIADD Holds the address of the users NMI service 

routine. 
NOTE - On previous machines, this did not 
work correctly and these two bytes were 
documented as 'Not used.’ Programs that 
used these two bytes for passing values 
mayneed to be modified 

a SCB2h (23730) RAMTOP Address of last byte of BASIC system area. 

2 SCB4h (23732) PRAMT Address of last byte of pysical RAM. 








Part 26 
Using machine code 


Subjects covered... 


USR with numeric argument 


‘This section is written for those Who understand 280 machine code. ie. the set of instructions that the 
2780 processor chip uses If you do not, but would like to, there are plenty of books about it. You should 
get one called something along the lines оѓ. 720 machine code (or assembly language) for the 
absolute beginner, and if it mentions the 7-3" or other computers m the ZX Spectrum tange. so much 
the better 


Machine code programs are normally written in assembly language. which. although cryptic, is nol 
160 difficult to understand with practice. You can see the assembly language instructions in part 28 of 
thischapter. However, to runthemonthe +3 youneed to code the program mtoa sequence of bytes 
„then called machine code This translation ts usually done by the computer itself using a program 
called an assembler There is no assembler built in 0 the +3, but you wil! be able to buy one on disk 
‘or tape. Failing that, you will have to do the translation yourself, provided that the program is not too 
long 


Letstakeasanexampie the program 


ld bc, 99 
ret 


„which loads the BC register pair with 89. Тоз translates inta the four machine code bytes 1, 99, 0 (for 
ld bc, 99)and 201 (for ret) (If you look up codes 1 and 201 in part 26 of this chapter. you will 
find that | corresponds to Jd be, NN - where NN stands for any two-byte number, and 201 corresponds 
toret) 

When you have got your machine code program the next step 15 to get it into the computer - (ай 
assembler would probably do this automatically) You need to decide whereabouts in memory ta 
locate it- the best thing 15 to make extra space for it between the BASIC area and the user-defined 
graphics. 


Hyoutype 
CLEAR 65267 
this will give you a space of 100 (for good measure) bytesstarting at address 65268 


To putin the machine code program you would гип BASIC program something like 


10 LET a=65268 

20 READ п: POKE a,n 
3@ LET а=а+1: GO TO 20 
40 DATA 1,99,0,201 


{This willstop wih thereportE Out of DATA whenittasfilledinthe four bytes youspectfied ) 
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c ee 


То тип the machine code. you use the function USR - but this {ипе with а numenc argument, te. the 
starting address. Из result is the value of thie BC reamster ол return from the machine code program. so 
you type 


PRINT USR 65268 


you will getthe answer 99. 


The retum address to BASIC is ‘stacked’ in the usual way, so return is by а 780 ret ifstriiction. You 
should not use the ТҮ and I registers m è machine code routine that expects to use the BASIC interrupt 
mechanism If you are writing а program) that might eventually run on an older Spectrum (up to and 
including the +2), you should not load 1 with values between 40h and ТЕП (even if you never use IM 
2) Values between COh and FFh for I should also be avoided if contended memory (ie. RAM 4 to 7) is 
to be paged m between CO00h and FFFFh This is due to an interaction between the video controller 
and the 280 refresh mechanism. and can cause otherwise inexplicable crashes, screen corruption ог 
other undesirable effects. Thus, you should only vector IM 2anterrupts to between 8000h and BPFFh, 
unless youare very confident of your memory mapping (ot you are oniy going to run your program on 
the +3 where thisproblem doesnot exist) 


The system vanabie at 5CBOtr (23728) was documented on previous models of the Spectrum as 
‘Not used’ It is now used on the +3 as an NMI jump vector ЇЇ an NMI occurs, this address is 
checked Ий contains 0. then no action is taken. However. for any other (non-zero) value, a jump will 
be made to the address смел by this vanable NMIs must not occur while the disk system is active 


There are a number of standard pitialis when programming а banked system such as the +3 from 
machine code. If you are experiencing problems, check that your stack 1s not Бета paged out curing 
itermupts, and that your interrupt routine ts always where you expect it Io be (itisadvisable to disable 
interrupts during paging operations). Itis also recommended that you keep a copy of the current bank 
register setting in unpaged RAM somewhere as the роз ate write-only BASIC and the editor use the’ 
system variables BANKM and BANK678 fcr TFFDh and | FF Dhresnectively. 

It you call +3р05 routines remember that interrupts should be enabled upon entry го the тоште. 
Remember also that the stack must be below BFEO (49120) and above 4000h (16364), and that there 
must be at least 80 words of stack space available 


‘Youcan save your machine code program easily enough with Gor example) 


SAVE "name" CODE 65268,4 


On the face of it there is no way of saving the program so that when loaded it automatically runs welt 
however, you can get round this by usmg the short BASIC proaram 


10 LOAD "name" CODE 65268,4 
20 PRINT USR 65268 


Which should also be saved (asa separate program) usmo the ommend (for example) 
SAVE "Loader" LINE 10 
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Then you may tun the machine code from BASIC using the singie command, 


LOAD "Loader" 


which loads and automatically runs the BASIC program which їп turn loads and runs the machine 
code. 


Calling +3DOS from BASIC 


When BASICs USR function is used, the code it references is entered with the memory configured as 
illustrated below (left) 1e. the ROM switched in at the bottom of memory m the address range 
(00001, .3FFFh) is ROM 3 (the 48 BASIC ROM) The RAM page at the topof memory 1s page O and the 
machine stack resides in this area (unless the CLEAR command has been used to reduce it to 
somewhere below C000h). As explamed in part 27 of this chapter (which describes ће +3005 
routmes), DOS can only be called with RAM page 7 switched in at the top of memory, the stack held 
somewhere m the range 4000h- BPEQh, and ROM 2 (the DOS ROM) switched in at ће bottom of 
memory (0000h...3FFFh). This configuration is illustrated below (nght) 


In BASIC 
(after USR) (using DOS) 


Co00h C000h 


8000h 8000h 


4000h 4000h 





0000h 0000h 


Consequently tt will be necessary to switch both ROM and КАМ, and move the stack before and айг! 
calling one ofthe entries in the DOS jump table The following very simpie example shows one way of 
achieving the desired set up inorder to call DOS CATALOG 


If BASICs CLEAR command has been used so that the BASIC stack is below BFEOh (49120), then it t= 
not necessary to move the stack. However. we have done so in the following exemple to demonstrate 
the technique when this is not the case 
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Se aaaaaaaaaaaaaaaaaaaasaassssssssssssssssssssssiħÃįÅi 


Asimple example to call DOS CATALOG. 






















erg 7800: 
aystat sw jarbilrary value picked to be belou SFEBr and above 4000! 
staksto here to put BASIC's stack pointer 
апат eau systes variable that holds the last value output to 7FFON 
port! equ dress of RON/RAM switching port in 1/0 map 
сатун! eau jsowewhere for DOS to put its catalog 
dos.catalog eau ithe 005 routine to tali 
seno: 
ai unwise to switeh RAN/ROM without disabling interrupts 
td (stakste) sp save BASIC'S stack pointe: 
id bepport) the horizontal ROR switch/RAM Switch 1/0 adaress 
n a, (бап) system variable that holds current switch state 
res p e right to left in "orizontal ROM switch (3 to 2) 
or 7 suiten in RAN page 7 
ld (bake) ya Must Keep system variable up to date (very important) 
out [2n the switch 
n Sp myst Sure Stack ig above 490% and below BFE 
“ interrupts сап now be enabled 


j The above will have swttened in the DOS ROM эла RAM page 7. The stack t 
j located in а "sate" position for calling 205 


also be 









i The following ts the tódé to set up ard cali BOS CATALOG. This ts where your own 
+ tode woulo be plated. 












1а ho catbutt isomewhere tor DOS to put tne catalog 

n Be, catbutfet 

Ir bc, 026 wr їз actually O4e13415 = 4S 

n [LI] 

In We sure at least first entry їз zerbi sed 
n bok the nusber of entries in the buffer 

n tl include system files |^ tne catalog 


ld сенын! утте (peatron to be Titled with the arse catatog 














18 м ithe file n 
tail — dos catalog ег! тле DOS entry 

push at We flags and possible error nusber returned by 005 
pop т 

m (dosret), nt ut it where it can be seen troa BASIC 

la tab ve пиже of files in catalog to low byte of 8С 
te D iris will be relurned i^ BASIE by the USR function 








1! the above sortea, then BC holds number of files im catalog 
be tilleg with tre alphanumerically sorted catalog ang the ca 
will be set. This will be peeked from BASIC to сле: 


the "catbuff^ witt 
y flag bit in "dosret" 
if ali went well. 









Having mage the tali to DOS, it is now mecessaty tò Unda the BOM and RAM switeh and 
put GASIC's заса back tc where it was on entry. The following will achieve this. 
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di jabóut to RON/RAR switch so be careful 
push be nusber of files 
n be,portt aadress of norizontal ROMAAN switch 
ia à, (banta) f current switch state 
st а nove left to right (ROM 2 te RON 3) 
aro Fn jatso want RAM page @ 
n (banka) pa jupáate the system varvable (very aportant) 
out (ela jaake tre switch 
Pp ъс A the saved nüsber of tiles in catalog 
(а ур, (stake ae) four BASIC's stack вася 
ret ireturm to BASIC, value in BC is returned to USA 
starasvars 
deth haer FrN ithe file пате, must be terminates with FFA 
dosret? 
dee d ja variable tc be peeked trom BASIC 10 see if ij worked 


As some of you may not have an assembler available. the following 1s а BASIC program that pokes the 
above code mto memory, calls i, and then uses the value returned by the USR function and the 
contents of dosret to printa very simple catalog of the disk 


10 LET sum=0 

20 FOR i=28672 TO 28758 

30 READ п 

40 POKE i,n : LET sum=sumtn 

50 NEXT i 

60 IF sum <> 9387 THEN PRINT " 
Error in DATA" : STOP 

70 LET x-USR 28672 

80 IF INT ( PEEK (28757)/2)= P 
EEK (28757)/2 THEN PRINT "D 
isk error "; PEEK (28758): 





STOP 

90 IF x=1 THEN PRINT "No files 
found": STOP 

100 FOR i TO x-2 





110 FOR ј=0 TO 10 

120 PRINT CHRS ( PEEK (32781+1* 
13+3)); 

130 NEXT j 

140 PRINT 

150 NEXT i 

160 DATA 243,237,115,0,144,1,25 
3,127,58,92,91,203,167,246, 
7,50,92,91,237,121,49,255,1 
59,251 
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170 DATA 33,0,128,17,1,128,1,0, 
4,54,0,237,176,6,64,14,1,17 
,0,128,33,81,112,205,30,1,2 
45,225,34,85,112,72,6,0 

180 DATA 243,197,1,253,127,58,9 
2,91,203,231,230,248,50,92, 
91,237,121,193,237,123,0,14 
4,201 

190 DATA 42,46,42,255,0,0 


‘The addresses picked for the above code and trs data areas are completely arbitrary. However, Lisa 
good idea to keep things in the central 32K wherever possible so as not to nin into the pitfall of 
accidentally switching out a vital variable or piece of code 


Ifinterrupts ате to be enabled (ав 15 the case m the above example), 1t 15 imperative that the system 1s 
kept up to date about the latest ROM switch. This means that the user must make the BANK67B system 
Vanable reflect the last value output to the portat LFFDh. Asshownby the above example: the general 
technique is to take а copy of the variable in А. sevreset the relevant bits, update the system vanable 
then make the switch with ап OUT instruction Interrupts must be disabled while the system variable 
does not reflect the current state of the port The port at 1 FFDh doesn't just control the ROM switch, so 
setting the variable to absolute values would be very unwise Using AND/OR with a bit mask or 
SET/RES instructions isthe preferred method of updating the vanable 


Just as BANK678 reflects the last value output to IFFDh. BANKM should aso be kept up to date with 
the last value output to 7FFDh. Agam it 15 unwise to use absolute values, as the port is used for other 
purposes. For example. the bottom 3 bits of the port are used to select the RAM page thats switched 
into the memory area CO00h.. PFFFh (thus is also shown m the above example). Naturally. when more 
than one bit js to.be set/reset, а bit mask used with OR/AND is the more efficient method) Note that 
RAM раста was described m the section entitled Memory management m part 24 of thts chapter 


The above was а very simple example of calitna DOS routines The following shows one or Wo extra 
Techniques that you may find useful However, if you ate sot already familar with assembler 
programming, it might be better to skip this example 


Although part 20 of this chapter suggested that the opening menus Loader option first looks for à 
file called ж and then one called DISK before tryina to joad the first file from tape - this isn't exactly 
the whole story The first operation actually trres to load a bootstrap sector from the disk in dtive A 
The sector on side 0. track Ü sector 1 wall be used аз а loader (bootstrap) if the system finds that the B 
bit checksum of the sector is 3 The following program ensures that the checksum of 512 bytes 
conforms to this requirement, then whites the information to the diskiñ the correct position. Once a 
disk has-been modified m this way. the Loader opnoz be used to automatically load and run 
the disk: Alternatively, the BASICcommand LOAD "ж" canbe used 











This example was developed using M80 on а CP/M based machine - so the method used to ensure 
that the code is as- «mbled relative to the correct address might be different from that used by your 
ownassembler 


i Simple example program to write a boot sector to the disk in drive àz, 


by Clif! Lawson 
copyright (c) AMSTRAD Pie. 1987 




















E] фата iris at not using MAO 
equ Fron — "horizontal" ang RAR switch port 
вом — BS8SCh associated system vari 
esu — OTFFDR vertical” switeh port 
pm 857^ Ssot lated system vary 

select eau rn ASIC routine to open sir 
des tel авро equ 81518 

dé write sector ваш @)66т ee part 27 of teis chapter 
ad lagin eou фт 

org a 


sohase 








COM file thet has addressed relative to 7 
ogepraginiDly ie 
SPECTRUM FORMAT апа loaced with 


(Таја a ines MBA to generate a 
Assenbie with "ИВО = prog" ang 
This can be меасва with COP 
LOAD... CODE 78672. 





i 





A different techninue eli probably be required tor осімен phsesbke: 














Starts 
ta (о(з(ә%),%р ave BASIC’ а stack porter 
n stereo tat ых атас belos suyteres RAN pages 
push oy state for the sumest 
1а мучан 
ш у 205 ret itob point to KOPB 4: (necessary for calling Db 
tall 0одов Fraatiees? 
1а E] plog r dist In unii д ао that arsting sectors 
pa^ i ont say "aisa sat beer tanen 
n уза login 
ssil nodes 
pw n 


ni ,bestsecto 








be S12 
a 
(bootsectors i5) oa ireset cnecesue for starters 
D Е wiil sols B Dit sue 
з p 
ads ГАП is toop maces B By) себат ot 512 5014 
4 Ме TE 
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dec ы 
td а 
or t 
ir па ,скАдор 
ld ae A now Más B bit Checksus of the sector 
col jones се mt (eT will give negative value) 
аа as 902 3 to wake sue = 3 + 1 to wake tuos compl 
n (bootsector+15) 24100 make bytes checksus to 3 mod 256 
n ar ce 
ta 
\а 
to sector 1 (8 because of logical /pnysical trans.) 
la daress of info. to write as boot sector 
(7 1y 02 wr*te.sector 
tali dodos jactually write sector to disk 
рор ir iput 17 back so BASIC can reference 119 systen variables 
4а sp,(olstan) iput original stack bati 
ret jreturn to USR rail in BASIC 
dodos: 
i TY holas the agaress of the DOS routine to be run. All оттек registers are passed 
i intact to the DOS routine and are returned from 11. 
j Stack» somewhere in central 32K (conforming to DOS fequirénents), so saved AF and 
} BC will not be surtenes out, 
push а 
рит — bt tenp save registers while switching 
[t] a, {banks RAM/ROM Switching syster variable 
or ? want ? 
res 4a ana 
n bt,bankt ort used for horiz ROM switch and RAM paging 
[n 
1а (вата) „а jeep system variables up to date 
out (©), TRAM page 7 to top and 00$ ROM 
e 
pop wt 
pop — af 
call junprote igo yub routine address in 44 
push — at sreturn from JP LIY) aiii be rò here 
Bush е 
i (barn) 
ám 0а" ireset bits fr cage 6 
ret m teh to ROR з (68 BASIC) 
id bc bank! 
а 
ia (dante) а 
sut (ya ge @ ana 48 BASIC 
HI 
pop № 
рор — a^ 
ret 
йимин: 
ie oy istandará say то CALL (IY), by calling this jump 
зау» 
E [1 фаезешлеге to put BASTC'S stati pointer 
p "м 





тузак: enough stack tc seet +3005 regui-emenIs 


bootsector: 


-depnase ithete are WEE psevdo ops. your assembler 
-phase ØFEI 





Bootstrap will load into page 3 at ascress FEDO». The cose will be enterez at FEIN. 


Before it їз britten to track B, sector 1, the bootstrap "as byte 15. changed så 
that it will cnecksum to 3 mod 256. 


Boot will seiten the memory So that thE GE BASIC ROM is ar the bottom. Neit UO 1s 
раде 5 ~ the screen, ther page 2, and the top «ill азер page 5, аз Pt woulo Бе 
i umWise to switch out the Bootstrap. BASIC routines can be calles with any RAP 
i page suited im al the top, bat the stack shoulen't be (я tne TSTACE а 


























bootsrartr 
j The bootstrap sector contains the 16 byre gisk specrtfcation at the start, T>e 
i tollowing values are for a AMSTRAD PCW range EF2/Spectrus +3 format dian, 
ob a З toraat 
ab 0 ingle sided 
b Ц 8 tracts cer sice 
ab s sectors per tract 
db 2320512)-7 = sector з 
db reserped trace 
ab locks 
ab sirectory blora 
db 
ob 
ds 
eksyn a o Fepeceyue must = $ aog 256 far tae sec 
The booratrsp wili Be enterer here with the а, 7, 8, $ FAM pages sei lits in 





Te print something, же Peed SE BASIC tn at tre bottom, gage 5 (tre streer and 





























system varvables) nert og, The nent page arii be @, ama are Lop atil pe dept 
as paye 3 because st stili contains the Bootstrap ana stack (stack 
on entry. 
ay 
la ay (beris) 
ала Hie 
or s 294и page 3 (aw vy saiat бзидин) 
set m зечаті- гате Nos 
m be barat 
le (bares) pa 
(Oya їз! RAN ana sory zontal QOR 
a, (bare 
з 
“ iei bit 2 and seser Bet без FON M 
а 
IU 
ка Pauls ré» Pave 83,5 
is p 
sali select ESASI ROM үгө të geen жга Mi 
“ ^i yseskadc 
zak print sor ine à жезге 





————————————————— 


loop: 


j énd with ar endless Loop changing the border. Tats 15. where your oun code 
i fur a game or operating system woole gn. 





là ar да "ai-Verj^randow randon umber 
our (tehlua Fsuitch the border 
ir eloon гапа Loop 
print: 
le т, aths just loops printing characters 
rp e фм! dt finds FFA 
ret з 
rst LI ajsit BBE RON in, this wili print cnar in A 
ane ^ 
ir print 





0,22, 11 





AALAN 





"нен, 





d evening and eico 


itte 
as 512-(cii HP bootstart),ü SINUL da end of vector with Os 


eni 


There are one or hwo things that may be worth noting about this example The first is that because 
BASIC normally has the address of the ERR NR system variable held in IY (so tt can easily reference its 
system variables) Its important to store IY and replace it before returning to the ongmal USR call 


Just as before ће stack 18 moved so that tt sits in the central 32K of memory. This will allow -3DOS 
routines to be called without having to move it again. 


The dodos subrounne may be useful in your own programs Itonly uses the TY register - which isnt 
used by the +3DOS system and allows a call to be made to any of the +3005 routines 


The program uses DOS REF XDPB to make ІХ pomt at the relevant ХОРВ for drive A. If then jogs in 
the disk in A so that it can be wntter fo. After calculating and modifying the checksum byte for the 
information to be wntter to the béot sector of the disk. it writes the boot sector using DD WRITE 
SECTOR 


No checks are made to see that there 1s even a disk interface and possible errors ate. ignoted - the 
тойппе isn? designed to be usadi by those unfamiliar with possible pitfalls: The routine can be called 
with the BASIC commana. 


USR 28672 


which will come back with whatever number BC happens to contam after completion of the routine. 


‘The boot sector that & written to the disk has а standard disk specification in the first 16 bytes This is 
followed by the bootstrap code that will be entered at address КЕ10һ. As wall be described m the 
interface for DOS BOOT (see part 27 of this chapter), the meniory will inihally be set up as 4, 7, 6,3 
however, the BASIC system variables are still intact and BASIC can be operated by switching in the 
correct ROM (3) to the bottom of memory and making sure that page 51s m the 4000h. TFFFh area of 
memory. 


This very simple boot program just uses the BASIC ROM to print a greeting then enters a tight loop 
Changing the border colour, It could be modified tn load a large binary file and enter ir or perform апу. 
Other action you desired 
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Part 27 
Guide to +3DOS 


Subjects covered... 


ROMs 

+3DOS interface 

File attributes and headers 

Disk format and specification 
Tracks and sectors 

Disk parameter blocks 

CP/M file compatibility 

Changing disks 

Logical to physical drive mapping 
+3005 messages and requirements 
+3DOS routines 


This section describes +3005 ~ the disk operating system of the +3 The informanon will probably 
be of most interest to people familiar with assembly langua: inne code) procramming (see part 
26 of this chapter for more mformation on this subject) What follows1s highly technical, and should not 
be used by the unimitiated 








‘The operating software of ће +3 1s m effect, held m four ROMs (though the mation 1s actually 
contained m just two ICs) All four ROMs are addressed between 0000h and 3FFFh although only one 
isswitched їп а! А nme. 


ROM 015 the editor ROM arcs the one entered when the +9 ts first switched'on This controls the 
high level menu and editing functions. 


ROM | is the syntax’ ROM and handles the high level contra)of +3 BASIC. it eontams the code for 
the BASIC parts of most of the disk based commands 


ROM Sis ће 48 BASIC’ ROM and is virtually identical to Ihe ROM used inthe very first Spectrum The 
only real area where it 1s different is in the code executed when ar interrupt occurs If nor zero а 
ticker variable is decremented every second interrupt and when it reaches zero the disk motoris 
switched off This yanable is heid page 7 along with some of the editor and DOS variables, Page 7 
wtil only be switched in (and this variable decremented) if bit 4 m the FLAI lable 1s set 
thisis used by the software to identify whether it is running 48 BASIC or +3 В, B BASIC. 
1s selected (from the mam menu or by the SPECTRUM com 
page-switching and ticker-decrementina won't happen However 
variables subsequently set by your own program: this process will start н 
watillselectod 





































The keypad scanning routes of the Spectrum. [28 and +2 tave been removed from ROM 3i: 
the +3 
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— —————_——————_— 


A ‘hug im the orignal 48 BASIC ROM has been fixed in ће +3. When a non maskable mtetrupt (NMI) 
cceurs а Jump1s made to location 86h. This now checks the contents of the NMIADD system variable; 
Itiriszero a RETN is executed otherwise а jump is made to the routine address held in NMIADD. The 
NMI code in ROM 2 consists of justa RETN 


ROM З not only provides the 48 BASIC mode for program compatibility, but executes the majority of 
+3 BASIC commands that don't make use of the more advanced hardware ofthe +3. 


The fourth ROM (ROM 2) holds +3005 - the disk operating system. This is the subject of this section. 
Unlike the other ROMs. which are unlikely to be of much use for assembler programmers (except the 
48 BASIC ROM perhaps), the +3005 ROM hasa wealth of routines that may well be of use in your own 
programs We strongly recommend that any software that uses the disk drives makes use of Ihese 
routnesas they provide most of the facilines that one could wish for (more than are currently used by 
BASIC. in fact). Furthermore, the routines should only be accessed via the jump block This not only 
makes it easter to write software that can be adapted to and from the AMSTRAD CPC range of 
computers, but also affords upwards compatibility for the future. The entry points for each routine are 
held in a jump table at address 0100h (256) in the ROM. Part 26 of this chapter gave a couple of 
examples of the way m which these roulines can be called. 


A 3DOS provides the following facilines: 


‘Support for one or twa floppy disk drives and à КАМОК. 

CP/M Plus and CP/M 2.2 fle compatibility 

AMSTRAD CPC range and PCW range file and media compatibility 
Upto 16 files open at the sante nme. 

Reading and writing files to or from any pace in memory. 

Byte level random access 

Delenng disk files, renaming disk files, changing disk files áttmbutez 
Selecting the default drive and user. 

Booting a game or operating system: 

Low levelaccess to floppy disk driver. 

Optional mapping of two logical drives (A cr B.) ontoone physical drive (unt () 


Pe ee OR 


+3DOS interface 


+3D0S's infertace i58 set of routines accessed via а jump block The routes provided fall into three 
categories 


* Essermalfüng system routines. 
+ Additional routes for games and operating systems 
* Low level floppy disk access routines for disk formatting. copying) eic: 












The 
routines fu 


Essential filing system routines 




















Low level floppy disk driving routines 


коөт [тыш | 


DD INTERFACE isthe floppy disk driver interface present? 
DDINIT isk driver 

DDSETUP cify drive parameters 

DDSET RETEY 

DDREADSECTOR 

DD WRITE SECTOR 

DDCHECKSECTOR 

DD FORMAT Formata track 

DDREADID Reada 

DD TEST UNSUITABLE 

DDL 

DDSEL FORM г XDPB for DD FORMAT 
DD ASK (external drive) present 

DD DRIVE STATUS Fetch drive 

DDEQUIPMENT Whattype 

DD ENCC 


DDLE 

DDLSEEK 

DDLR 

DDL WRITE 
DDLON MOTOR 
DDLTOFFMOTOR 
DDL OFF MOTOR 





Games and sents Mu BAM. беради 


+3D08 provides t 











hole machine (see the 





some st 


f the m 


program to take 
jot required, 
jr ой and 
t10 prevent any bank 





contro} 





d without 








Using +3DOS without a floppy disk interface 


Even ifthe floppy disk interface were not present, +3005 could still be used as follows; 
* Only drive M tsavajlable (the RAMdisk) 


* The default dnve for filenamesis mitialised to М. rather than A. 

* Anyatfempttousednves A orB willfailwitherror22 - Drive not found 

* As the sector cache 15 not required for use with RAMdisk, the swe of ће RAMdisk 1s 
increased to 64K (the whole of pages 1. 3 4, 6). This will ave 62K of data and 2K of directory 
(64entnes) 


* ‘The presence of the floppy disk interface can be determined by calling DD INTERFACE: If 
the interface were not present, then none of the other low level floppy disk routines (DD 
etc.) could be called; the effect of so doing is undefined. 


File attributes 


Bit 7 of the name and type field characters are the file attributes The top bits of the name field 
Characters are denoted [] {8 The top bits of the type field characters are denoted 11. 13. They have 
the following meanings. 


th {4 -Available to the user 

fi {8 -Reserved (always0) 
ti ~Omeans file isread-write; | means files read-only 
12 -Ümeansnot system file, | means system file 
13 +O meansnot archived; | means archived 


A readonly file cannot be written 0, erased or renamed. 
the directory catalog. The archive attnbute is ignored by 





m files can. optionally. be omitted from 
DOS 


Newly created files have all attributes set to 0 An existing file's attributes can only be changed by 
DOSSET ATTRIBUTES (as used by BASICs MOVE command) 


File headers 


Tape files have headers which contain some sy 
headers All tiles created by BASICs SAVE с 


The +3005 header mechamem provides a aedicated B byte area 
BASIC suse The remameder of the header vedfor--3DOS T 
created by BASIC commands (see DOS OPEN desctiption) 
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+3005 files may have a single header m the first 128 bytes of the file - ће header record. These 
headers are detected by a ‘signature’ and checksum If the signature and checksum are as expected, 
then a header is present, if not, then there 15 no header. Thus, 1t 1s possible, but unlikely, that а Ше 
without a header could be mistaken for one with a headet. 


The formatof the header record isas follows 


BytesO Т +3005 signature - 'PLUSIDOS 

Bytes -1АҺ (26) Soft-EOF (end of file) 

Byte8 -Issue number 

Byte 10 Version number 

Bytes|| 14 — -Lengthofthe filem bytes 32 bit number. leastsignificant byte wx 
lowestaddress 


Bytes 15,,.22 -+3 BASIC header data 
Bytes23...126  - Reserved (setto0) 
Byte 127 -Checksum (sumof bytes. 126 modulo 256) 


The issue and Version numbers are provided for any future expansion. The issue number must equal 
the software's issue number the version number must be less than or equal to the software's version 
number 


+3005 performs all the necessary header house-keeping А pomterto +3 BASICsB byte header 
area may be returned using DOS REF HEAD. It is never necessary to wnfe directly to the 128 byte 
header 


AMSDOS headers (as used on the AMSTRAD CPC range of computers) will not be recognised 
AMSDOS files will be treated by +3DOSas headeriess and vice versa 


Disk formats 


+3005 supports exactly the same disk format as CP/M Plus and LocoScript on the AMSTRAD PCW 
range of computer word processors (ie the first format listed below) 


The following formats are automancally detected when the disk Is first accessed. 


AMSTRAD PCW range single track (eg. as used on model PCW8256) 
AMSTRAD PCW range double track (eg. as used on model PCW8512) 
AMSTRAD CPC range system format 

AMSTRAD CPC range vendor format 

AMSTRAD CPC range data only tormát 


Note that the AMSTRAD CPC range's IBM format is not supported 


Other disk formats can be used by patching the XDPB for a dive, Пе XDPB is the sameas for thefirst 
format listed above. tt ts northe same asonthe CPC range 


see Re 
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Disk formats are subject to the following restrictions. 


512 bytesector size 
Maximum of 255 sectors per track 
Maximum of 255 tracks 

Maximum of 256 directory entries 
Maximum of 360 allocation units 


*ox ox x 


Logicaltracks and sectors 


The disk driver routines require logical tracks and sectors These are used 6 hide mformation 
concerning the number of sides and the actua! sector numbers from +3005, which knows nothing 
about them. 


Logical track numbers ona single sided disk are the same as physical track numbers 
For double sided disks, two optionsare available 


1 Alternating sides. 


side 0 track 0 = logical track 0 
side | track 0 = logical track | 
side 0 track 1 = {ogicaltrack2 
side | track | = logical track 3 

to 
side 0 last track = local track n+! 
side | last track = lomcaltrack n 





2 Successive sides 


side Otrack 0 = logical track 0 
side 0 track | = logical track | 
side track 2 = logical track 2 
to. 
side 0 last track = logical track n/2-1 
and then. 
Side | last таск-1 = logical track w2 
side | last track-2 = logical track r/2* | 
side | last track-3 = logical track 2+) 
to. 
side | track 0 = joarcal track n 








where nisthe total number of logica! tacks (ie. 2 х number of races per iae: 
Logical sectors hide the actual physical sector numbers Logical sectornumbersalyays start from, 


Lomcalsecter = physical sector - first sector 
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Disk specification 


The PCW range disk 
which is defined in th 
The format used on the 
also that t 
example x 











tor 1, track 
ding this specification is 
wn in the second 






ard PCW ra 
ard CPC rar IDSSST system format 


јата CPC ra SST data only format 








_———————————— 


Extended disk parameter blocks (XDPB) 


Tms contains а 














AMSTRAD PCW range single track format (type 0) 
(Asusedbythe +3) 








AMSTRAD CPC range SYSTEM format (type 1) 






AMSTRAD CPC range DATA ONLY format (type 2) 








CP/M File compatibility 





+3005 uses the CP/M file structure subject to the fallowine restrict. 





* Maximum file size of 8 megabytes (CP/M Plus supports а maximum of 32 megabytes), 





mum of 128 megabytes) 





CPM Plus supporisa m 


*N Bs w erased, renamed. etc. along with their file(s) but àre 





16 zero when a file а created. but ary 





* No date and time stamps SF 


Xherwise iat 

























1 red, te из ted by ай routine лер! DOS SET 

t ány jen mt Dyt sociated with each 

inter is th =: tobewrittenorread The 

file pointer is autornancally advanced alter each read ot w m however the user may setit 
D alue required for rard = 

The end of fi west byte p ition 

Files without hea rd the М ры 





cetlina (EOF / 128 

















Under +3р05, a 
lhereare no file: 


A disk should ти 






there ar 
the correct di 
Note that cha 








required logical Itnot then CHAN к {СЕ passed c 
messageand the ч Е А 





Please put the disk for x: into 
the drive then press any key 





(where xis the r {the jr ti watt for а key lo ly 
pte fore теш һе required loa 
tr 

SMAP Bow be used tore-miap Bento um i ifumt 1d feast then drive В isdisabled 


+3DOS Error codes 





Many +3D0S tout (ай. Thus is inaieatea with carry : ian ertor code m the Ате 
The error codes ate 


Recoverablecis errors 


Drive not ready 

Disk is write protected 
Seek fail 

CRC data error 

No data 

Missing address mark 


Unrecognised disk format 

Unknown disk error 

Disk changed whilst +300$ was using it 
Unsuitable media for drive 











А 
Non-recoverabie errors 


Bad filename 

Bad parameter 

Drive not found 

File not found 

File already exists 

End of file 

Disk full 

Directory full 

Read-only file 

File number not open Sigma 
Access denied (f 

Cannot rename between: уез 
Extent missing ch should be ther 
Uncached t 

File too big (tryingtore 

Disk not bootable 

Drive in use (try 








> таром Unsuitable media for drive ased by trying to write 
a double track drive, or trying to read or write а double track disk in a single 





track driv 


The re 
isnot fi 


disk that 





х! Міѕѕіпд address BEL 
matted (althoudh th the sol 











) then, in the event of a recoverable disk error 
epromptedio= Retry, 
he reply is I 
and an error condition is 


erable, then nc 








Ignore or Cancel 
the 





nthe erroris ignore 
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The recoverable disk errars: 





: not ready 
disk write protected 

track m, seek fail 

track т, sector ss, data error 

track m, sector ss, no data 

track m, sector ss, missing address mark 
bad format 

track м, sector ss, unknown error 

disk changed, please replace 

: disk unsuitable 













Mristhe track m s the sector number 
Retry, Ignore or Cancel? 


messages if the error occurs o 
1! DOS OPEN ts called (with acces 


where xis the disk drive(eg А: or B 
lowed by 





The above messages area! 
The ALERT routine 1s 
committed to execute а DOS гош 
wnte or read/write) and the disk in the dry 
тапу clear and A= | (the ALERT routine v 
If, however, while reading data dunna DOS READ. a bad sector is found. ALERT wal) be called to 
warn the user This will then offer the opportunity of retrying (if for example the disk was no! properly 
seated їп the dnve), ignormg (so that the bad sector ул! be ignored allowing as much of the file as 
possible to be recovered), ot cancelling (perhaps because the problem is obviously recoverable) 

(Note that the routine interface for DOS SET MESSAGE has changed between is VI Cand V1: 
of -3DOS Its 1mportant therefore that DOS VERSION 1s called. ала that if the versi jmar* are 
greater than V1 0, he new routin ased. Tins ts the only chan )Oand VLI 




























+3DOS requirements 


When any of the +3005 routines are called the foil 
CO00h.. PEFEh (49 
000h. ВЕРЕһ ( 
4000h. 7FFFh (i 
0000һ 3FFFh (0. 16383) 

The stack must be below BFEOh (49120) 

than CO00h) because the top 30 b 












BFEOR (rather 
(oves Thie 
must have al 









above 4000h (16384), The upper 
2 sed to implement inter-pege blo 
















least 50 words avatlable 


+3005 supports up to 16 files o; 
+3 BASIC, so it would be ur 
be executed whiie a file rs sti 
the reportis@ OK) 





2 are utilised by 
IC command might 
tts an etror (even)! 


For each of the rounnes described m this section mtermipts must be enabied on entry. and will still be 


enabled onext 
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+3DOS Store usage 


RAME 









АШ+3005 routmes wa " 
The addre r se tout 1 be vs у 

which they are local ir 

Th 3 татр block t ted ROM 2 from address t DE мага: h jare: 
int chroutms 





Essential filing system routines 


DOSINITIALISE 
0100h (256) 





Error me 





ENTRY CONDITIONS 


EXIT CONDITIONS 
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DOS VERSION 
0103h (259) 


Get the DOS issue and version numbers. 


ENTRY CONDITIONS 
None 


EXIT CONDITIONS 
D= Issue 
Е = Version (withiissie, 
Always 
AF BCHL IN corupt 
Allother registers preserved 


DOS OPEN 
0106h (262) 


Create andor opena file 
There tsa choice of action depending c 


аспот or ‘create action’, and are spe 
followed: otherwise the create achon is & 







vhether ot not the file already The choices are ‘open 
led m DE Jf the fle already exists. then the open actions 
lowed 








Openaction 


| Etror- Г 





s already exists 





7. Openthe file. read the header (if any) Posmon йе pomer айе; heaaer 





3 Openithe file куп 





a any header Position file pointer at 0000 





4 Assume given filename 1з filename. type Erase filename. BAK (il it exists). Rename 
filename . type tc filename . BAK Fi n 





5 Frase existing version. Follo 





y create ach 





Create action 
|, Error - File doesnot exist 


2. Create and open new file witha header Postion file pointer 








5 Create and open new file without а header Position file pointer at 000 
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pen it. otherwise create 1t with а header 





he празои 
chon = | create action 








сез по! exist, sel operraction = |, createaction = 0) 





der, first re: y ех 





sting verston to „ВАК, set open 








Files with header: 
written byte positions 


lest byle position greater than all 








Files without headers have thetr EOF p n recorded as the byte at the start of the smalle 
record position greater than all written record positions 


Soft-EOF 15 the character | Ah (26) and is nothing to do v 
BYTE RE? 's about soft-EOF 





128 byte 


h the EOF position, only the routine DOS 












be used by the any purpose whatsoever [f 
d has а header) then the header data 1s read from the file. 
The header data 1s available even if the file does not have a 
the header dat: 





The header data are 
open action = } 
otherwise the he 
header Са} DOS REF HE 











Note that +3 BASIC makes use of the first 7 of th 


Program n io prog 





Numeric array 


Character arto 


CODE or SCREENS 





should be filled 







has à header, 


y be opened for 


write ted wnt 
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ENTRY CONDITIONS 
В = Pile numberÜ. 15 
C= Accessmode required 










Bits 0, 2 Values. 
1 z exciusive-read. 
8 = exclusive-wrie 
3 = exclusive-read-wnte 


5 =shared-read 
Ву 3..7 = 0(reserved) 
D=Create action 


Орепасћол 


HL = Addressof fi 











me (no wildcards) 


EXIT CONDITIONS 


Ие newly created 
Carry true 
Zero true 
Acorrupt 

Iremsting ile op 
Carry true 
Zero faise 
Acorrupt 

Otherwise 








BC DE Hl IX corrupt 
Allother registers preserved 





DOS CLOSE 
0109h (265) 


Close a file 


Write the header (ifthe 





Write any outstandin 





Update the directory 


Release the fle number 





All opened files must eventually be closed (c 10! be reused unti We 


closed (or abandoned) 
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ENTRY CONDITIONS 
B=File number 


EXIT CONDITIONS 
ок 









Сапу 





Other 





DOS ABANDON 
010Ch (268) 


Abancona file 





Similar fo TX 
зс 


IS CLOSE header, or data 
used to force a 


pie. if the media к 









ectory t 


sed m the 


yet to be wntten to di 
vent that DOS CLC 
vently changed or removed) 







ENTRY CONDITIONS 
B= Filè number 


EXIT CONDITIONS 
IOK 
Carry tr 


Асотщ 








DOS REF HEAD 
010Fh (271) 


Pointat the heat 











cmm 


Note that +3 BASIC uses these 8 bytes (see the note under DOS OPEN which aves the details). ЇЇ 
creating file that will subsequently be LOA Ded within BASIC. then these bytes should be filled with 
the relevant values 


ENTRY CONDITIONS 
B= File number 


EXIT CONDITIONS 
It OK. but fle doesnt haved header 
Carry trie 
Zero rue 
Acormpt 
IX = Addiressot header data mpage T 
IL OK, file has a header 
Carry true 


ето false 
Acorrupt 
IX = Address of header data m раде? 





Carry false 
A= Error code 
IX corrupt 
Always. 
BC DEHL corrupt 
Allotherregisters p 





DOSREAD 
0112h (274) 


Read bytes from a fil 





memory 
Advance the file pomter. 
r 


The destination buffer is in the fo 





ingmemoty 






guration: 


Conon FFFFh ¢ 
5000 BFFFh (3 
4000h ТЕРЕМ 

(noh. 3FFFh q 


This routine does not 





Reading ЕОР vali pre 





rr ——_—______—— 


ENTRY CONDITIONS 
B=Filenumber 








nber of bytest 
Address for bytesto be read 


{bytes remain 





тир! 





Allother cec 





DOS WRITE 
0115h (277) 


White bytestoa file from memory 


Advance the file роте: 





The source buffer isin the following memory configuration 
СОО FFFFh (49 
8000h BFFFh 9151) * Page2 
4000h IFFFh (i 32767) 
0000h 3FFFh (0.16383) 






ENTRY CONDITIONS 





BCHL IX corr 
Aljnther тесте! 
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DOS BYTE READ 
0118h (280) 


Reada b! 


Advance the file pomter 


efroma file 





Tests for soft-EOF (1Ah(26)) Asthiscondition latched. st is possible to read past soft-EOF 





EOP is latched 





The caller must decide whether or not soff-EOF is of interest. Thus wouid normally be the 
п ASCII file 











Reading EOF will produce an error 
ENTRY CONDITIONS 
В = Pile number 


EXIT CONDITIONS 

КОК: Byte <> LAh (26) (soft-EOF 
Сапу! 
Zero false 
Acorrupt 
C= Byte 

КОК -Byte = 1Ah (26) ( 
Carry tre 
Zerotrue 











Ceortupt 
Always 
BDEHLIXc 





Allother recistei 





DOSBYTE WRITE 
011Bh (283) 


Write a bytetoa file 


Advance the file pointer 


ENTRY CONDITIONS 





anaes 


EXIT CONDITIONS 
FOK 
Сату!те 
Acomupt 
Otherwise: 





Always 
BC DE HL IX corrupt 
Allother reaisters preserved 


DOS CATALOG 
011Eh (286) 


Filisa buffer with part cf the directory (sorted) 
The filename specifies rhe drive user and a (posstblhy ambiguous) hlemame: 


Since the size of a directory is variable (and may be quite large) this routine permits the rectory to 
be catalogued in s number of small secnons The caller passes a buffer pre-loaded with the first 
required filename or zeros for the start ofthe directory. The buffer is loaded with part (or all. ift fils) of 
the directory sorted m ASCII order If more of the directory is required, this routine is re-called with 
the buffer re-nitialised with the last file previously returned This procedure is followed repeatedly 
tinh allofthe directory has beer 









Note that +3006 format disks (which are the same as singie sided. Single track AMSTRAD PCW 
range format disks) may have 3 maximum of 64 directory entries: 


Butfertormat 







dad with the first filename. type required Entry 1 will contam the frat 
ter than the preloatied entry nosed preload entry is OK 






or the directory, this го 
Xrpart ef the directory 


th entry О replaced by 


Entry format (13 bytes oma) 


Bytes: 
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ENTRY CONDITIONS 
Bzn* I, Siscofbuffer inentnes, >=2 
C= Filter 


clude system files (1f set) 





EXIT CONDITIONS 
OK: 
Carry true 
A corrupt 
B= Number of completed 
Otherwise 
Carry false 
А = Error code 
Beorrupt 
Always 
CDEHL IX corrupt 
Allother registers preserved 


n buffer 0...n (If B = n the 





ү bemore to come] 





DOS FREE SPACE 
0121h (289) 


How much free space is there on this drive? 


ENTRY CONDITIONS 
A= Drve. А$С1ГА. Р 


EXIT CONDITIONS 
OK 
Carry true 
Acorrupt 
HL = Free space (tn kilobytes) 
Otherwise 
Carry false 





Always 
BC DE IX corrupt 
! other registers pi 
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DOS DELETE 
0124h (292) 


ENTRY CONDITIONS 
H Adare (t 


EXIT CONDITIONS 





DOSRENAME 
0127h (295) 


R 


File must not be oper 


ENTRY CONDITIONS 











t 
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DOS BOOT 
012Ah (298) 








ENTRY CONDITIONS 


EXIT CONDITIONS 
IfOK 





DOSSET DRIVE 
012Dh (301) 
atthe delault drive (te the dre iipliod t 


The default dr 


in 
Th tectsr 1 t 


ENTRY CONDITIONS 
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DOSSET USER 
0130h (304) 


Set the default user ar 





aset number 






The detault 








Thisonlya 1 ame parameter 
ENTRY CONDITIONS 

A= User РЕП (255) = get det 
EXIT CONDITIONS 





Additional routines for games and operating systems 


DOS СЕТ POSITION 
0133h (307) 


Getthe 





ENTRY CONDITIONS 
В = filenumber 








a ee 


EXIT CONDITIONS 
Ок. 
Carry true 
Acorrupt 
EHL = Pile pointer 000000h. .FFFFFFh (0 16777215) 
(E holds most sigmificant byte; L holds east significant byte) 
Otherwise: 
Carry false 
A= Enorcode 
E HLcorrupt 
Always 
BCDIXcorrupt 
Ailother registers preserved 


DOSSET POSITION 
0136h (310) 


Setthefile pomter 


Does nota 





3s the disk 


Does not check (or care) if pointer 1s > = 8 meg 
р -ga 





ENTRY CONDITIONS 
B=Filenumber 
EHL = Filepomter 000000h. .FFFPFFRh(O 1 
(E holds most significant Буте, Li hold! 





EXIT CONDITIONS 
IfOK 
Carry true 
Acorrupt 
Otherwise 





Always. 
BC DE HL IX corrupt 
Allother registers preserved 


DOSGETEOF 
0139h (313) 


Get the end of file (EOF) file positon ye the 
positions. 





п greater than ali written byte 


Does not affect the hie pomter 


Doesnot considersoft-EOF 








ENTRY CONDITIONS 
В = Filenumber 


EXIT CONDITIONS 
HOK 
Carry true 
Acorrupt 
EHL = File pointer 000000h..FFFFFFh (0... 16777215) 
(E holds most significant byte, L holds least siamrficant byte) 
Otherwise: 
Са 
A= Error code 
EHL corrupt 
Always 
BC DIX corrupt 
All other registers preser 











DOSGET 1346 
013Ch (316) 


Get the current location of the 





ie and RAMdisk 


Pages |, 3, 4 Gare со 
The cache and RAMahsi 


idered 





ray of 128 sector bufe 
jo separate uous) ate: 






numbered 0. 127) each of 812 bytes: 
ofthisatray 








Any unused sector butfers may be used by the caller 





Note that the sizes may be smaller than those specified m DOS SET 1346, as there 1s ап (unpublished) 
maximum size of cache and a minimum size of RAMdisk (4 sectors) 
























ENTRY CONDITIONS 
None 
EXIT CONDITIONS 
First buffer for cache 
Е = Number of c sector buffers 
H=f utter for RAMdisk 
1 yer of RAMdisk sector buffers 
Always 
AF ВСІХ corrupt 
|| other registers preserved 
DOS SET 1346 
013Fh (319) 


d RAMdisi- 





Rebutid the sector сас! 





This routine 1s used to make some store available to the user. orto rerumstore ta DOS 
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ee 


Note that ifthe RAMdisk is moved. or itssize is changed. then all fles thereon are erased 





Pages 1, 3, 4, 6 are considered as an array of 128 sector butters (numbered 0 - 127)eactof 512 bytes 
The cache and RAMdisk occupy two seperate (contiguous) areas ofthis апаў. 


The location and size of the cache and RAMdisk can be specified separately, any remaming buffers 
are unused by DOS andare available to thecaller 


The cache and RAMdisk must not overlap. +3DOS does not check tins responsibility lies with the 
caller. 

Note that the sizes actually used may be smaller than those specified.as m practice. there us н 
maximum cache size and a minimum size of RAMdisk (4 sectors) 


A cache size nO will still work but will seriously impair the floppy disk pero 





‘This routine will fat) lf there ate any filesopenondnve M. 


ENTRY CONDITIONS 
D= First buffer for cache 
E = Number of cache sector buffers 
H = First buffer for RAMdis« 
L= Number of RAMdisk sector buffers 
(Note that E+ L<= 128) 





EXIT CONDITIONS 

ок 
Carry true 
Acorrupt 

Otherwise 
Carry false 
А = Error code 

Always. 
BC DE HL Xcormpt 
Allother registers preserved 


DOSFLUSH 
0142h (322) 


Wnteany pending headers data diréctory entriesfor апу 





This routine ensures that fhe disi eap fo date. It еа аһаһу nme 





ENTRY CONDITIONS 
A-Ubnve ДСАУ Е 





DOS SET ACCESS 
0145h (325) 


tha aci 
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DOSSET ATTRIBUTES 
0148h (328) 


Seta file'sattributes 





Only the file attribui ЛГ 14 canbesetorcleared The face attributes 5... ар 





у50. 








This routine first sets the attributes specified in D. then 
prionty. 


imbutes specified in E. 1e. E has 


ENTRY CONDITIONS 
D = Attributes to set 
bito 







bit 1 
HL = Addressc nidcaras permitted) 
EXIT CONDITIONS 
КОК 
Carry trua 
Acorrupt 





Otherwise 
Carry false 
A= Eror code 
Always 
BC DE HL IX corrupt 
Allotherregisters preserved 





DOS OPEN DRIVE 
014Bh (331) 


Open the disk in this dnve asa singie file 








The whole disk is presente 
used to ехапиле/роке dire: 
or by anyone who values ther fi 











Sets file pointer to 000000h (0). 


Ifthere are any files open on this dnve from other file numbers with shared-read access, then the disk 
can only be opened with shared-tead access from this file number. 


It there are any files Open on this drive from other file numbers with exclusive access; then the disk 
cannol be opened from this file number 


ENTRY CONDITIONS 
A= Drive, ASCIL'A P 
B= Filenumber 
C= Accessmode required 
Виз0. 2 values. 
1 = exclusive-read 
2=exclusive-wnte 
3* exclusive-read-wnite 
§ = shared-read 
(all other bitsettinas reserved) 
Bus3..7 = 0 (reserved) 


EXIT CONDITIONS 

HOK 
Carry true 
Acorupt 

Otherwise 
Carry false 
A= Error code 

Always. 
BC DEHLcorrupt 
Allother registers preserved 


DOS SET MESSAGE 
014Eh (334) 


Evable/disable disk error messages. 


"This should be used to make +3005 aware of your own ALERT subroutine When 4-3DOS detects an 
error, it will call yout ALERT subroutine, passing to it the values documented below. The ALERT 
subroutine should print the text of the message that +3005 passes it, then should wait for the user to 
press a key, If the Key 1s in the reply string (that +3005 also passes - version VLO only), then а ret 
should be made with A=0, 1 or 2, or containing the character (depending on the version of +3D0S), 


ENTRY CONDITIONS 
А = Enable/disable 
РЕП (255) = enable 
00h (0) = disable 
HL = Address of ALERT routine (ifenabled) 
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— 





EXIT CONDITIONS 
HE = address of previous ALERT rout 
Always 
AF BC DE pt 





Allother rear 





ters preserved 


NOTE 


Note that if you are su 
conditions pa: 
subroutine must prod 














Note that there are tw 
+3005 version V 1.0) st 





ALERT (VERSION V1.0 ONLY) 


ENTRY CONDITIONS 
DE = Адаг 
HL = Addressc 






EXIT CONDITIONS 
A = Re 





FBC DE HI, IX corrupt 


Allotherreasters preser 


The sec 


Jeneral 





ALERT (VERSION V1.1 AND ABOVE) 


ENTRY CONDITIONS 
Error 








THermnated by 
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If you provide 


any and exite 





DOS REF XDPB 
0151h (337) 


Point at the XDPB for 





his div 








ENTRY CONDITIONS 
ASCI A. P 
EXIT CONDITIONS 


"amy my 





DOSMAPB 
0154h (340) 


Map drive: В to unit 0 orum 






lf mapping В t à kist [ 
rrect Iit isnt then GE In ask ir 
init 

mappo B to unit |, еп иши 1 does net exist. drive B is dissk 


ENTRY CONDITIONS 





Init 
Adare mat = 
EXIT CONDITIONS 
KOK 
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NOTE 
The definition of the subroutine CHANGE DISK is as shown ahead, Note that if you are 


substituting your own CHANGE DISK subroutine, ће ‘entry conditions are the солатопе 
passed to your subroutine, and the ‘exit conditions are registers you are allowed to corrupt. 


CHANGE DISK 
Ask the user to change the disk m unit 0 


‘Wait for the user to acknowledge the change. 


ENTRY CONDITIONS 
A= Logical dne. ASCINA, Р 
HL = Address of message (page 7) termmated by FFh (285) 


EXIT CONDITIONS 
Always 
AF BC DE HL [Xcorrupt 
Allother registets preserved 


Low level floppy disk driving routines 


The following are the floppy disk driver routines The unit number ts 0..3 for the uPD765A. Or 
the +3. uritüisdnve A and unit 1 isdnive В. or optionally both A. and B: may be mapped onto unit | 
Units 2and 3are not used 


With the exception of DD INTERFACE. none of these routines may be called if the floppy disk 
interface is not present 


All routines assume that interrupts are enabled on entry, and will still be enabled on exit 


DD INTERFACE 
0157h (343) 


Is the floppy disk drive interface present? (This information Is also held by BASIC in bit 4 of the 
PLAGS3 system variable.) 


ENTRY CONDITIONS 
None 


EXIT CONDITIONS 
Ifpresent 
Carry true 
Otherwise 
Carry false 
Always. 
A BCDE HL IX corrupt 
Allother registers presei 











DDINIT 
015Ah (346) 


Initialise the disk driver 


ENTRY CONDITIONS 
None 


EXIT CONDITIONS 
Always. 
AF BCDE HL IX corrupt 
Allother registers preserved 


DDSETUP 
015Dh (349) 


Setup disk parameters 
Sendaspecify command 


Parameter block format 


Byte 0 - Motoron time (in 100 mS units) 

Byte | - Motor off nme (in 100 mS ипи) 

Byte 2 - Write off time (in 10 uS units) 

Byte 3 - Head settle nme (in mS units) 

Byte 4 - Step rate (in mSunits) 

Byte § - Head unload time (in 32 mS units, 32. .480) 
Byte 6 - (Head load time x 2) + 1. (m4 mSurats 4 508) 


ENTRY CONDITIONS 
HL = Address of parameter block 


EXIT CONDITIONS 
Always 
AP BCDEHL IX corrupt 
Allother recisters preserved 








DDSET RETRY 
0160h (352) 


Setthe rryand retry 





опселе noretry.) 


ENTRY CONDITIONS 
А = Try/retry court? = 


EXIT CONDITIONS 
Always 

AF BC DE HL IX corrupt 

Allother regist 





DDREADSECTOR 
0163h (355) 


Reada sector 


ENTRY CONDITIONS 
В = Page for C000h (49192) ГРЕГ 






base 
ctor, base 
ssofbuffer 


f XDPB 






HL = Addi 
IX = Addr 


EXIT CONDITIONS 
IfOK 
Carry true 
A corrupt 
Otherwi 
Carr 
A = Error code 
Always. 
BC DE HL IX corrupt 
Allofherregistersc 
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DD WRITE SECTOR 
0166h (358) 


Writea sector 


ENTRY CONDITIONS 

B= Page for CO00h (49152) . FFFFh(65835) 
mt (0/1) 

3icai track. 0 base 

ctor, Ô base 

ss of buffer 


Address of XDPB 










EXIT CONDITIONS 
Ок. 
Carry ttue 
Acorrupt 
Other 








nae 

Always 
BCDEHLIXcortupt 
Allotherr 





erspreserved 


DD CHECK SECTOR 
0169h (361) 







that the 


that FFh (2: 
further details) 





nything (see n PD755A specification for 


ENTRY CONDITIONS 


е for СООО (49152). FFFFh(63835 
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—__——oeoeooo aaaaaaaaaaaaaaaaaaaaamamamamamsħŮŰ 


EXIT CONDITIONS 
IFOK(equ=!) 
Carry true 
Zero te 
Асопир! 
ШОК (not equal) 
Carry true 
Zero false 
Acorrupt 
Otherwise. 
Carry false. 
A= Error code 
Always 
BCDEHL IX corrupt 
Allother registers preserved 


DDFORMAT 
016Ch (364) 


Formata track (Uses the и PD765A format track command.) 
Buffer contains 4 bytes for each sector as follows 


C Track number (0.39) 

H Head number (alwaysOonthe +9'ssingle sided dnves) 
R- Sector number (0...255) 

N-Log:(sectorsize)-7 (2101512 bytesectors) 


ENTRY CONDITIONS 
B = Page for C000h (49152). FFFFh(66538) 
C=Umt(0/l) 
D= Logical track, 0 base 

Filler byte, usually ESh (229) 

HL = Address of format buffer 

IX = Addressof XDPB 





EXIT CONDITIONS 

OK: 
Carry true 
Acorrupt 

Otherwise 
Carry false 
А = Error code 

Always. 
BC DE HL 1X corupt 
Allother registers preserved 





eS 


DDREADID 
016Fh (367) 





Read ё sector identifier 
ENTRY CONDITIONS 
C= Unit (DI 
D= Loatcal tr: 
IX = Addr 











EXIT CONDITIONS 
WOK 


sof result buffer i: page 7 
p 
eserved 


DD TEST UNSUITABLE 
0172h (370) 


Check that disk is suitable lo write 








Asingle track disk will not work ma double track drive, and vica 





ENTRY CONDITIONS 





EXIT CONDITIONS 
Ifswtable 
ry true 
A corrupt 
Otherwise 
Carry false 
A= Error code 
Always: 
BCDE HL IX corrupt 
Allother reqisters preserved 
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DDLOGIN 
0175h (373) 


Loginans 





Intialise the ХОРЕ 


This routine does not aff 





ENTRY CONDITIONS 


(01) 


Addres 














IX 





EXIT CONDITIONS 
OK 
Carr 







Othe 





Error 
DE HL corr 





BC IX corrupt 
Allother ге 





DDSELFORMAT 
0178h (376) 


|пїпайве an XDPB for a stai 


i format 





This iiile йди alle} oz 





ENTRY CONDITIO: 
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EXIT CONDITIONS 
ок 
Carry true 
A= Disktype 
eof 2 bit 
ize of hash table 









Allotherreaisters preserved 


DDASK1 

017Bh (379) 

Check to see tl unit | is present (BASIC holds this informanon in bit of the FLAGS3 system variable. ) 
Turn motor on 


Fetchdnve status 





Мили | isnot-ready arid wnite-protected, then unit ) 15 missing. Start motor off timeout. 





Note thal thisrounne can 





е fooled by di are almost but not quite, inserted in the drive 


This route assumes that when а disk 1s not in the drive. then wnte-protect 1s true. This ts indeed tha 
case for 3 inchand B inch disk drives. but isnot the case for 5 /, inch disk drives. 





ENTRY CONDITIONS 
None 


EXIT CONDITIONS 

Ifumt present 
Carry true 

Othenmse 
Carry faise 

Always 
ABCDEHE IX corrupt 
Allpther remsters preserved 











251 





DDDRIVESTATUS 
017Eh (382) 


Issuea sense dnve status command 


ENTRY CONDITIONS 
C = Uni/head 

bits 

bit2= head 
bits3.7=0 





rut 


EXIT CONDITIONS 
A = ST3 (Status recister- 30! nPDT65A) 
Always 
FBCDEHLIX corrupt. 
Allother reaisters preserved 


DD EQUIPMENT 
0181h (385) 


Ask what type of drive thisis (te. single/double track. singie/double sided) 





"Track information can only be determined once а disk has be 
during logging in. 


1 seen and had its type identified 


Side information can only be detected after a double sided disk has been seen and had из type 
identified dunng logging m. 


ENTRY CONDITIONS 
nit (0/]) 
Address of XDPB 








EXIT CONDITIONS 
A = Side/track information 
bits 0, side inforn 









bie sided 

= track information 
inknown 

ingle track 

ible track 











Always, 
FBCDEHLIXcorrupt 
Allother registers preserved 
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DDENCODE 
0184h (388) 


Set the copy protection ENCODE subroutine 


Copy protected disks have some of their track and sector numbers encoded on disk Before each disk: 
access. the ENCODE subroutine is called to encode the the physical track and sector numbers. 


These encoded track and sectornumbers must match those m the sector identifier. 
Notethat tracks(). 2 or: etther side ofa disk should not be encoded 


ENTRY CONDITIONS 
A= Enable/disable 
00h (0) = disable 
FFh(255) = enable 
Ні = (Ifenabled) addressof ENCODE subroutine 


EXIT CONDITIONS 
HL = Address of previous ENCODE subroutine (0ifnone) 
Always: 
AF BC DE IX corrupt 
Allother registers preserved 


NOTE 


The definition of the subroutine ENCODE is as shown ahead. Note that if you are substituting 
your own ENCODE subroutine, the ‘entry contitions are the conditions passed to your 
subroutine, and the exit conditions are the values that your subroutine must produce and the 
registers you are allowed to corrupt 


ENCODE 


ENTRY CONDITIONS 
C= Unitside 
bits® 1 = unit 
bit? = side 
bits3.7= 
D = Physical track 
Е = Physicalsector 
ЇХ = Address of DPB 





EXIT CONDITIONS 
D= Encoded physical track 
E = Encoded physicai sector 
Always 
AF corrupt 
Allother registers preserved 
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DDLXDPB 
0187h (391) 


Initialise an XDPB for a ven format 


This routine does not 





ider the free 











ENTRY CONDITIONS 

ІХ = Address of destination XDPB 

HI = Addre disk specification 
EXIT CONDITIONS 

WOK 





DE HL corrupt 
Always 

BCIX corrupt 

Allother reg: 





DDLDPB 
018Ah (394) 


Initialise a DPB for ac 





This routine does not 


ENTRY CONDITIONS 
IX = Addressof destinati 
HL = Address of source disk sc 





EXIT CONDITIONS 
ОК. 
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DDLSEEK 
018Dh (397) 


Seek to required track 
Retry fail 


ENTRY CONDITIONS 
head 









ІХ = Addressof XDPB 


EXIT CONDITIONS 
ШОК. 





DDLREAD 
0190h (400) 


Lu 


Read data 





level uPD 





Wntesco 





Reads data 





255 


П Hes 


Reads results 


Motor must be running 


ENTRY CONDITIONS 
HL = Address of parameter block 


EXIT CONDITIONS 
HL = Addressof result bufferin pa 

Always 
AFBCDEIX 
Allother reg 








rupt 
preserved 





DDL WRITE 

0193h (403) 

Low level uPD765A write command. 
White data 

Wnte deleted data 

Formata track. 

Scan equal 

Scan low or equal 


Scan highorequal 





Parameter block form 


Byteü Page for СООО (4! 
Bytes |2 Add ff 
Number of byt 
Byte5 Number of 
Bytes Command byte 



















Wnitescommands 
Wnites data 
Reads results 


Motot must be runmng 


ENTRY CONDITIONS 


HL = Addressai param 











EXIT CONDITIONS 





рр ом MOTOR 
0196h (406) 


Turnon her 
Wait for the mot ur 


ENTRY CONDITIONS 
None 


EXIT CONDITIONS 








DDLTOFF MOTOR 
0199h (409) 





ENTRY CONDITIONS 


EXIT CONDITIONS 


DDLOFF MOTOR 
019Ch (412) 


Turn ot ther 


ENTRY CONDITIONS 


EXIT CONDITIONS 
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Part 28 
Spectrum character set 


Subjects covered... 


Control codes 
Characters 
280 assembler mnemonics 





sthe comple 
ing 280 machine 
assembly language mn u 
starting with CBh or EDh. 1 mthetwor 
between 48K апа. +3 (128K) modes the 48K 





Specii 











CODE CHARACTER 


] 


4 | motus 





cursor right} 
cursor down <> 






Cursor up > 
[DELETE] 
[ENTER] 
number 





] BRIGHT < 

0 INVERSE n 4 rh 

z OVER contr 5 ^ x 

22 AT contr ‹ зам lth 

E ТАВ contra пз 

" ] E "t 
PA pide пс 








Totused 


` 


шо тте сше оу н дч» ++ o0 wa tmm. 





Z80 ASSEMBLER -AFTERCBh -AFTEREDh 


ida (de) 
decde 
ince 
dece 
йек 

па 

wm DIS 
ld hi. NN 
Id (NN) hi 
inc hi 
anch 
dech 
аһм 
daa 

iz Dis 
аад 
lähl (NN) 
dec hi 
mei 

dec! 

Id LN 

cpl 

jrn DIS 
ldsp. Nh 
Id (NN)a 
incsp 
ine (hi) 
dec (hi) 
Id (hi) N 


sc 
tc DIS 

add hisp 
Ida/NN} 








dan 


idbb 
kibe 
пра 
Idbe 
аһ 
ldt 

‘db (hi 
idba 
licb 





па 
пе 
mh 
mi 
mr (hl) 
па 
slab 
Зас 
slad 
slae 
siali 
sia 
sia (hl) 
slaa 
stab 
зас 
srad 
зае 
srah 
stal 
sra (hi) 
заа 


mbie) 
out(c).b 
sbc рс 
Id (NN) be 
neg 

тет 








—_ 
CODE CHARACTER HEX Z80ASSEMBLER -AFTERCBh -AFTEREDh 








B I 49 lice bic »ut(c)c 
74 d 4 Idea bild adchlbc 
B K 4B асе bit Le ld be,(NN) 
76 L 4c ldch bitih 

тї м 40 ldel ы теп 

78 N 4E lác(hi) Tnt L(hi) 

19 0 4F lica bit la ldra 

B0 Р 50 iddb bit2.b їп@ (с) 

8! Q 51 мас bil2c out (c).d 
2 R 52 idad bit2d sbc hide 
83 $ 5 idde bitze id (NN)de 

84 T 54 аһ bizh 

85 у 55 аа! bwal 

86 V 56 lad (hi) bit (hl) imi 

81 W 57 ldda bit2a Ідал 

88 x 58 ldeb bit3.b ine (c 
89 ri 58 Мес bitic out(c)e 
90 1 5А ded ЕЕС adc hide 
gt г 5B Idee bt3e idde,(NN) 
92 \ 5С ldeh bitr3h 

93 1 50 ldel bit$] 

94 1 БЕ Ide (hl) bita (hi) mê 

95 = oF Wea bit3a аат 

96 £ 60 idhb bit4.b шс) 
97 а 61 Idhe bitse out (c). 
9g b 62 аһа bit4d sbe hi hl 
90 c 63 idhe bitte 1d (NN) hl 
100 а 64 ldhh bir 

101 е 65 аһ bit, 

102 + 66 Id h (hi) bit4.(hl) 

103 9 67 idha bitáa па 

104 h 68 аЬ ilc) 
105 i 69 idle out (C)! 
106 j 6A юа айс 
107 к 5B ‘dle Id hl. (NN) 
108 t 6С idih 

109 m 80 [iH 

410 n 6E ld Lht) bit (hl) 

I о oF idle bitSa tid 

Ma p 70 ld (hl), bi&b ntlo) 
113 q 71 (с bit&.c 

14 г юа bir&d abc hisp 
115 5 Іа (hie bige iJ INNI sp 
116 t аһ хер 

ш ч ld (hi) bul 

118 v i halt tafe (ht 

ng LI n Ы) Елба 
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(s) 
SPECTRUM 
PLAY (u) 
RND Б 
INKEYS 








user 
graphics 





Z80 ASSEMBLER -AFTERCBh -AFTEREDh 


kab 
ldac 
lidad 
бае 
ldah 
idal 
Ida (hi) 
Юза 
аадар 
adda.c 
addad 
addae 
adda. 
adda,! 
adda (hl) 
addaa 
adcab 
adcac 
adcad 
adcae 
adcah 
айса. 
adca,(hl) 
айсаа 
subb 
sube 
за 
sube 
subh 
sub 

sub (hi, 
suba 
seab 
sbe. 
sbcad 
sbcae 
sbeah 
са 
sbca (hl) 
sbcaa 








ande 
andh 
andi 
and(h 


bit7b 
bit; 
ыта 


ma(c) 
out (c);a 
adc hisp 





bite 
bitZh 
bil 
bit Z (hil 
bit7a 
Tes 


lásp(NN) 





1501 
reso. (hi) 
resOa 
resi b 
tes |c 
res 1, 
Tes Le 





res 
res2 (hl) 
res2.a 
res3.b 
res3.c 
res3d 


idi 
пр! 
шт! 
oun 
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CODE CHARACTER HEX 780 ASSEMBLER 











167 PI y anda 
168 FN Ag xorb 
169 POINT А9 хос 
110 SCREENS АА хога 
111 ATTR AB xore 
172 AT AC xorh 
173 ТАВ AD xorl 
174 VALS AE xor(h) 
175 CODE AF xora 
176 VAL BO orb 
177 LEN Bi 

178 SIN B2 

119 cos Bi 

180 TAN B4 

181 ASN B5 

182 ACS B6 

183 ATN Bi 

184 LN Bà 

185 EXP B9 

186 INT BA 

187 SQR BB 

188 SGN Ё 

189 ABS BD 

190 РЕЕК BE 

19! IN BF 

192 USR o 

193 STRS Ci 

194 CHRS Сг 

198 нот Сз 

196 BIN CA 

197 OR Cs 

198 AND C6 

198 <= Ст 

200 >s Ca 

201 <> со 

202 LINE CA 

203 THEN CB 

204 TO cc Iz NN 
208 STEP Ср call NN 
206 DEF FN CE adea. N 
207 CAT OF tst 
208 FORMAT Do тыс 
209 MOVE р! popde 
210 ERASE р? ipoc NN 
BLL ОРЕМ # рз 

012 CLOSE# De 

213 MERGE 





CODE 
214 


216 





219 
220 
221 





228 
723 
230 
231 
232 
233 
234 
235 


238 
239 
240 
p 
042 
243 
244 
248 
246 
247 
ie 
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CHARACTER 


VERIFY 
BEEP 
CIRCLE 
INK 
PAPER 
FLASH 
BRIGHT 
INVERSE 


OVER 
ойт 
LPRINT 
LLIST 
STOP 
READ 
DATA 
RESTORE 
NEW 
BORDER 
CONTINUE 
DIM 
REM 
FOR 
GOTO 
GO SUB 
INPUT 
LOAD 
LIST 
LET 
PAUSE 
NEXT 
POKE 
PRINT 
PLOT 
RUN 
SAVE 
RANDOMIZE 
IF 

cLs 
DRAW 
CLEAR 


RETURN 
copy 








-AFTERCBh -AFTEREDh 





ет?) 
set2a 
setib 
set3ic 
staa 
set3e 
set3h 
set} 

Imstructions 

using ix. 

sbcaN 

rst 24 

Tetpo 

pophi 

Ippo.NN 

ex [sp) ht set4e 
set4h 
set 4, 
set 4.(hl) 





xorN 
rst 4f 
tetp 
popaf 
фр 





set& (hi) 
setba 














Part 29 
Reports 


Subjects covered... 


Reports and messages 
CONTINUE 








Reports appear at the bottom of the screen whenever the +3 has st 
They explain why it has stopped - be it for so 






и has occurred, 


nber or le 


d the i 


Most reports have 
explaining what happ 





ad), a brief message 
ип the line) wi 
it is at the beginn 














Reports pertaining to disk operation (or +3005) do not start 
ahead in alphabetical order 


The behaviour of the CONTINUE 
CONTINUE goes to the lin 
reports B. 9 and D 


orienter - they are show 






mand depends vi uch on the reports Normally 
port, but there are 








d statemen! specified m th 





tions with 


Here 1s а table showing all the reports The 
report can occur, and th ju to part 31 
that the error А Invalid argument c 
then look up езе keywords m part 31 of this ch 
are valid 








ances tlic 
from the table 
id USR If you 


sh argument 





Disk errors marked by RTC (m the left-hand column 
ки ATA Ignore or Cancel? 
t the second column will be dis 





and statemer 
BEAT without FOR 
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Out of screen 
А INPUT 
^3 nes the 
PRINT AT 22,x 
Number too big 
Calculations have yieide 
proximal 
RETURN without GO SUB 
е amore RETURN th 


STOP statement 
Alter this CONTINUE wi 


т 


Integer out of range 





amable 


LET INPUT, FOR. 
DIM GO SUB 
LOAD MERGE 


Somenm 


PRINT AT 

Any arithmet 
RETURN 

STOP 

SAR LN. ASN.ACS 


RUN. RANDOMIZE 
POKE DIM GO TO 
G0 SUB.LIST 
LLIST PAUSE 
PLOT CHRS PEEK 
USR numeric 











Nonsense in BASIC 
The ИП 


Out of DATA 

Youh ned fo READ раз!!! 
Invalid filename 
SAVE with filer mpty 
haracters usin 


No room for 


STOP in INPUT 
Some INPUT data st STOP Li 

s е f 1t CONTINUEY 
behave normally by repestmg the INPUT stater 


FOR Without NEXT 


INPUT #2,а$ 





VAL VALS 


LOAD SAVE 
БЕГ, BERGE 


^N BREAK or th 
е bar 


OPEN # 
CLOSE # 
INPUT # 
PRINT # at 
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REPORT/EXPLANATION SITUATION 


Invalid colour 
The numbe б 








BREAK 


into program 
BREAK; tect 


Statement lost 


amp toa statement that no longer e 


Invalid Stream 


Teadin 


Too many brackets 


br. rounda 





Invalid baud rate 





Invalid note name 
PLAY cam 





























INK PAPER 
BORDER. FLASH 
BRIGHT 
INVERSE OVER 
alsoafter one of the 
corresponding contr’ 
characters 












CLEAR possiblym 
RUN 








RETURN, NEXT 
CONTINUE 


INPUT # 
OPEN # 
PRINT 4 








FN 


VERIFY LOAD 
MERGE 











PLAY 






FORMAT LINE 





PLAY 
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Number too big 
Aparameter fora 
big 


Note our of 
Aseriésofsh 


rr 


Too many tied notes 
Anat T 


Bad filename 


The e used 


value 


range {tis unlikely th 


CRC data error 


Code length error 
Trying t 1a CODE file ftor 
the value we LOADS 


Destination cannot be wild 
Try атай icátionf 





PLAY 


САТ, COPY 
ERASE, FORMAT 
LOAD MERGE 
MOVE SAVE 


Unlike 
Unlikely 


CAT COPY 
ERASE LOAD 
MERGE MOVE 
SAVE 


LOAD CODE 


COPY TO 


СОРУ TO 
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[cone woman — [sme —] 


Directoryfull COPY SAVE 


k full COPY SAVE 


Disk has been changed CAT COPY 
While exe snotice ERASE LOAD 
5 n n MERGE MOVE 
SAVE 


LOAD "+" 
een made t 
disk that di 


Disk is write protected COPY ERASE 
attempt has been n te toa disk wh te FORMAT. MOVE 
le t п є SAVE 


is not present FORMAT 
n made the FORMAT 


Drive in use 


Drive not found CAT.COPY 

А п nd contan ERASE LOAD 
MERGE MOVE 
SAVE 
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ux [eee 





















Drive not ready CAT COPY. 
A disk ithedriye ERASE. FORMAT 
wi ns because there 1s no LOAD, MERGE 


disk m the drive. It wil = y be possible to simply put 
adisk in the drive and type 
End of file found 
Anattempt has been made to 
end-of-file position. It i iki 
seen 


MOVE SAVE 










йл 





à byte past the 
ly that this report 





be 











File already exists 
The destination filenan: 


MOVE TO 












File already in use 
т LOAD MERGE 
SAVE 






that this error 








File is read only COPY ERASE 


























Trying to upd: > ot save using the name cia file MOVE SAVE 
that has its protection апше set (using th d 
MOVE filename TO "+P 







MOVE 
pron 


TO "-Р 


















File not found 
The filename given for one of the disk r 
= file that doe 


COPY ERASE 
LOAD, MERGE 
MOVE 


Unlikely 








MOVE TO 







Invalid drive FORMAT 
Aunveje ther than А: etB: 


s FORMAT сс 
















270 


[сое | натона CO 


Missing address wark CAT COPY 

A conti ERASE, LOAD 
MERGE MOVE 
SAVE 


inhkely: COPY 
LOAD MERGE 


CAT COPY 
ERASE LOAD 
MERGE MOVE 
SAVE 


No rename between drives MOVE TO 
hasbeen the MOVE сотта: 


CAT COPY 
ERASE FORMAT 
LOAD MERGE 
MOVE SAVE 


Unknown disk error кеў CAT. COPY 

A 1 ured that f isnot ERASE FORMAT 
nir rt r LOAD MERGE 

MOVE SAVE 
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[cone [ заттан [этил — ] 


Unrecognised disk format CAT COPY 
le trying to rea: n т ERASE. LOAD 
b à k MERGE MOVE 
SAVE 


Unsuitable media CAT COPY 
The disk int a Юта! that tsu Thi ERASE, FORMAT 
ni L D LOAD MERGE 
MOVE SAVE 
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Part 30 
Reference information 


Hardware 


The +3 jsdesuned around the 780А microprocessor. which uns at a speed 01 3.3409 MHz (about 
three and halfmilioneycles per second) 


The 43's memory 15 divided mto 84K ROM and 128K RAM. arranged їп 16K pages. The four ROM 
pages (0-3) can be mapped into the bottom: 16K (0000h-3FFFh) of the memory map. The eight RAM 
pages (0-7) are usually mapped into the top 16K (CO00h-FFFFh) of the memory map. RAM page 515 
@lso mapped mto the range 4000h-ZFFFh. and RAM page 21s mapped into the range 8000h-BFFFh. 
There are also several FAM page combinations that occupy the full 64K address range These were 
gwenn part 24 of this chapter. under the heading Memory management 





Physically speaking, the ROMs are two 22K devices (similar to the 27256). which are both treated by 
the system as two 16К chips The RAM is composed of four 64K x 4 bit chips (41464) some of which 
(RAM. banks 4-7) are nme-shared between the carcuitry that produces the screen display: and the 
780A. The others (RAM bares 0-3) are for the exclusive use of the 780A. as ts the ROM. 


For the contended RAM (which shares time between the video circuitry and the processor), during 
128 out of every 228 CPU T states (! TV me) ana dunng 192 out of every 311 TV lines (1 frame) the 
CPU is allowed only 1 access ю contended RAM in every B T states The CPU is controlled hy 
introducing wait states. 








Executing NOP instructions їп contended RAM will have an effective average clock frequency of 
266МНг (a reduction ofabout 25%) 


‘The Uncorinatted Logie Array (ULA) handles most ef the РО such as keyboard tape interface, parrot 
the pninter interface and screen handling It converts bytes in memory into patterns and colours on the 
screen. and allows the Z80A to scan the keyboard and read and wnte data ta tape 


The three-channel sound is produced by the AY-3-8812.- a very popular sound chip. ала thus device 
also controls ће RS232/MIDI anc AUX ports 


The two senal ports can be dnven only by software The +3 has nc software suppor for the AUX. 
port -thisisleft to the user's discretion. The RS232/MIDI port is fully supported from +3 BASIC 


The way їп which the AY-3-8212 works 1з айе complex and the would-be experimenter rs advised to 
get the manufacturer's data sheet The following informsnon should be enough to uet things 
underway. however 





The sound chip contains sixteen redisters which are selected by wnting frst to the address write port 
ҒЕРОҺ (65533) with the register number. and then reading the register value (same address), or 
мутла to the data remster элке address BFFDh (49149). Once a remster has been selected. any 
number of data reaci/wntes can be made; the address write port need only be re-writteri ќа different 
reaister needs to be accessed 
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The basic clock frequency of the circuits | 1/34 MH} (100 01%). 
The registers do the foliawing. 


RO-Finetone contro! channel А 
RI - Coarse tone control channel A 
R2- Fine tone control channel B 
R3- Coarse tone control channel B 
R4- Fine tone corittol channel C 
R5- Coarse tone control channel C 


The tone of a channel tsa 12 bit value taken from the sum of D3-DO of the coarse register, and D7-D0 of 
the the fine register. The basic unit of tone is the clock frequency divided by 16 (ie 110.83 KHz), and 
witha 12 bit counter range, frequencies from 27Hz to 110 KHz сап be generated. 


R6 - Noise generator contro), D4-DO 


The period of the noise source is taken by counting down the lower 5 bits of the noise register every 
spund clock period divided by 16. 


R?- Mixer and l/O contro! 


D7-Notused 

D6-1 means input port 
-Ümeans utpat por! 

DS- Channel C noise 

D4- Chánnel В noise 

D3- Channel A noise. 

D2- Channel C tone 

DÌ -Channel Btone. 

D0- Channel A tone 


This register controls both the mixing of noise and fone values fór each channel. and the direction af 
the 8 bit lO port. A zero m à mix bit indicates that the function s enabled. 


R&- Amplitude control channel A 
R8- Amplitude control channel B 
RA- Amplitude control channel C 


D4  -imeansuseenvelope generator 
-Ümeans use value of D3-D0for amplitude 
03-00 - Amplitude 


These three registers control the ampatude of each channel and whether or norinis moduiared by the 
envelope registers 


RB - Envelope coarse period control 
RC- Envelope ine penod control 
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П eee 


‘The eight bit values in RB* RC are summed to produces 16 bit imber whichis counted down in units 
01256 multiplied by the sound clock Envelope frequencies can be between 0. 1Hz and 6KHz. 


RD- Envelope control. 


D3- Continue 
D2- Attack 
D) - Alternate 
D0-Hold 


The diagram of envelope shapes (in part 18 of this chapter) gives à graphic illustration of tHe possible 
settings for this register 


The disk drive 1s controlled by the uPD755A floppy disk controller chip. As described in part 23 of 
this chapter. the data register for this device is at address 3FFDh (16381) and the status register ts at 
2FFDh (12288), This is а very complex device and it would be unwise to attempt to use it without full 
details ofits operation (see the manufacturer s data shee!) 


The Centronics parallei pnnter port i$ basically just ar; 8 bit data latch (74273) whose address is ÜPPDh 
(4083). The STROBE signal for the the pnnter 1s produced by ће ULA and is accessed using bit 4 of 
address ІРРОЋ (8189) The state of the BUSY line trem the printer 1s read from bit 0 of address OPFDh 
(4093) 


— 


Part 31 
The BASIC 


Subjects covered... 


Number handling 
Variables 

Strings 

Functions 

Brief summary of keywords 
Mathematical operations 


Numbers ate stored to an accuracy of 9or 10 digits. The largest number you can get is about 10% and 
the smallest (positive) number is about4 x 10 


Unless a number represents arvexact power of 3 theres a possibility thet mathematical inaccuracies 
may become apparent after repeated addition, sublraction, ete This is true of all computers that do 
nol use BCDanthmetic, Use of integers is sucgested i absolute mathematical accuracy is required 


A number 1s stored in the +3 їп floanng pomt binary with спе exponent byte е (1<=е<=255), and 
four mantissa bytesm ( /,€2m«1). This represents the number m x 2" 





‘Since '/<=m<1, the most sigmficant bi of the mantissa m is always | Therefore mactual fact we can 
replace it witha bittoshow the sign -Q for positive numbers 1 Sor negative 


Small integers have a special representation in which the first byte is 00h (0) the secandisa sign byte 
(00h or FFh) and the third and fourth are the integer itself (in twos complement form) with the least 
significant byte first 


Numeric variables have names o! arbitrary length starting with а letter and continuing with jétters. 






etter Ong 


be the s 
variable. They may have many dimensions of arbitrary size. Subscript vat 













name of a simple 





Stringsare completely fiexible m lenath The name afa string consiste of a sinule letter edby $ 






String arrays can have many dimensions of, 
тау not be the same as the name of a sum 
same fixed length, which is specified as an extra 
valüesstart at | 





array have the 
т Subscript 





Sitcria: substrinasof strings may be specified це} 





(jempty 


(aja numerica 











(ai) optional numerical expres: 








and is used in expressing a substring by either 


(а) string expression (slicer 





b) sting array vana 





whichis the same as 





string arta; 





In (8), suppose the stn: pty. the result is s$ 


(considered as a sul 











If the slicer is à пш t 15 the mth character of s$ (a 


substring of length 1) 





value is 


the: 





Ito« 





Slicing tsy 





efunchonsor 


{to (see LET) Kastnag quote istot 





sdictate otherwise) 





Substrings c: 
be doubled 


imus 





зета! 








ts à constant ot а vartable (optionally 
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je instruction 


ina (c) 


INKEYS Reads the keyboard. The result 
є ter representing the 
3 there isexactly 
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SCREENS 

















AVAAY I 


Уни 























Xyz 









тп 
i : 

ч 

d гоа the 

5 тер colons. А 





oul m; ot 
3PAPER INK FLASH BRIGHT INVERSE or 





OVER statement 


Note that optio 


Arbitrary expressi 
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BEEP х,у 


BORDER 


BRIGHT m 


CAT [#n,) [d] [a] EXP 


CIRCLE х,у, 
CLEAR 


CLOSE Mr 





sa RES 


TORE ar 


sequently printed. 0 for 


pare’ 


phanumerically 
din the form 


goft 


with ir 


y) 


MOVE 


52 


аре 


and 


170 


space they previously 


ICLS re: 


icomer 


tsthe PLOT 
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CONTINUE 


COPY EXP |INVERSE 


tinbute i 


INVERSEr 


COPY u TO u 
COPY aTO а 
COPY GTO d 





eportFile already exists willtx 
reportMissing address mark 
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COPY u TO SCREENS 


3 TO LPRINT 


TO SPECTRUM 
FORMAT 


DRAW х,у 
DRAW х,у, 





T le ifthe еб à tothe printer 
No character trans nd 


this form 


Partofthe DATA list Must beinar therwise 


n Must bein a program, 
пета 


ng 


and sets up an array lof 


ions 
ned 


by DIM 
Error 4 ifhereisno room to fit the 


DRAW x,¥,8 


ang x 
while turning 








x TO y 
TO y STEP 


FORMAT 


FORMAT LINE г 


FORMAT LPRINT 


GO TO 
IF x THEN 








PRINTER 


wCHRS 32 
CHRS 127 


160 TO 
n t RETURN 
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INPUT (41, f s separated (asin 


ed to the 
yand 
type 
contain tw! 
ы Ifthe 
f STOP: SYMB SHIFT: d 
WH (it) slike (n 
ral without 


INVERSE 


x INV VIDEO sey is 
toINVERSE 1 nig the TRUE VIDEO 
nt to INVERSE a 


not be 





LIST [iri 
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LIST [#m,] n Г farting 
nthe 
nt to the 


е directed to the RS232 
iFORMAT LPRINT 


acht ( 
1РОВМАТ 
restore this state iit has 


by FORMAT LPRINT "U" 


t default input device 


ms(COPY ERASE 


1ST, ther ál 


DATA 10) 

DATA .$() 
+ CODE m,n 

CODE т 


CODE ck to the address from whe 


* SCREENS LOAD í CODE 16384,6912 











LPRINT Like PRINT, but usin Use ће FORMAT 
{tout to the Centronics 
(PRINTER) т RS232 — dto set expansion of 
У ntto the 
ded and codes below 
sare tobe 
х mmand 
FORMAT LPRINT "U" bef ing LPRINT If 
punter output has been set tc RS232 (цепа the command 
FORMAT LPRINT ") then LPRINT canbe 


i characterstoa remote 


х delete old program linesor 
ay fornewones with the same 
* LOAD. the filename may 
líadnveletteris 
їй drive will be used 
MOVE ! Т0! This wi met tof, Bothfilesf, and f, must beon 
the same anv 


MOVE u TO Tliestngfmay be " ep", "+5", "+a" "pn 
he attributes of the file 
or unset( 7), The attribute 
rotection (Р), systeni 


) The CAT. EXP 
штелі settings 
savedover, or have any 
nae themin any way performed 
from the normal 
iby the CAT. EXP 
provided for compatibility 
ss and has. ther relevance to 


leting any program and 
ip to and including the 
ble RAMTOP. 
SPandPIPare 
pening menu, but dt 
AMdisk). 
(1) Finds the 
(ш) Adds: 








he Се PRINTER 
FORMAT LPRINT 


1 OVER snd INVERSE 
PLOT t tef 











fter the first The 
+ or - followed by 
ninted m ordinary 


e .03ani8.3 


йа! 


wed by 
elab 


lournem whichtakesthe formofa PAPER 
INK FLASH BRIGHT INVERSE TOVER 


RANDOMIZE RANDOMIZE Ø 
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RANDOMIZE п 


READ vi, Vsus Vi 


1 ot be treated 


RESTORE RESTORE 0 


RESTORE п є the DATA pointer tothe first DATA statement 
n > exist (or ta DATA 
s DATA nt 


RETURN Фа reer tmementotimeGO SUB stack 


the stack 
Е m+ en alanced by 
RETURN 
RUN Ø 


і itpüt device 
COPY ERASE 
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SAVE 


SAVE 
SAVE 
SAVE 
SAVE 


f LINE m 


f DATA 10) 
f DATA I$O 
f CODE m,n 
f SCREENS 


SPECTRUM 


VERIFY | 


Saves the program and variables so that if they are loaded, 
there isan automatic jump to line m. 


Savesthe numenicarray. 1C) tothe filet. 
Saves the character array: I$ () tothe file f. 
Savesnbytesstartngataddress m. 


SAVE í CODE 16384,6912 Savesthecurrent 
screen display. 


Switchesfrom +3 BASIC into 48 BASIC, maintammg any 
program in RAM. There is no switch backto +3 BASIC. 
Note that ROM/RAM switching ıs not disabled when 
entering 48 BASIC using this command, (thisis not the 
case when the option 48 BASIC isselected from the 
opening menu) 


Stops the program withreport 9. The CONTINUE 
command will resume the program from the following 
Statement 


Like LOAD (from tape), but the tape information ts по! 
loaded into RAM - instead, itis just compared against what 
isalready in RAM. 

Ifthe filename specifies a disk file (or if the current default 
dnve is A or B.) then no action is taken. 

Error R ifthe comparison shows different bytes. 














Part 32 
Binary and hexadecimal 


Subjects covered... 


Number systems 
Bits and bytes 
This section describes how computerscount, using the binary system 


Most European languages count using а more or less regular pahem nt rens- in Enolish, for example; 
althoughurstarts offa bit erratically, it soon settles down mto regular groups 





twenty, twenty one. twenty two... twe 
thirty, thirty one, thirty two, thirty nisi 
forty, forty one. (опу мо. forty mne 


ету nine 





and so on, and this is made even more systemanc with the numerais that we use However, the only 
reason for using ten (the decimal system) is that we happen to have ten digits on our hands (fingers 
and thumbs) 


Instead of using the decimal system - based on fen computers use a form of binary called 
hexadecimal (or ‘hex for short) which is based on sixteen. As there are only ten digits available inour 
number system we need six extra digits ю do the counting. So we use А В C. D, Band F And what 
comes after Р? Well, just as we. with (еп fingers, wnte 10 for ten (a hand full). so computers use 10 for 
sixteen, Comparing counting in decimal to hex 








DECIMAL HEX 
0 0 
1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 1 
8 8 
9 9 
10 A 
п B 
12 с 
13 D 
14 E 
18 F 
16 10 
17 п 

conhnued. 








25 19 
26 1А 
27 1B 
31 IF 
32 20 
33 21 
ес 
158 9Е 
159 9Ғ 
160 AO 
161 Al 
ate 
285 FF 
256 100 
andsoon 





It you are using hex notation and you want ta make the fact quite plain. then write h at the endo! ihe 
number, and say hex’ For instance, for one hundred and fifty eight (decimal), write 9Eh and say типе 
E hex 





‘You may be wondering what all this has to do with ters [n fact, computers behave as though 
they had only two digits, represented by а low voltage (or off) known as0, and à high Voltage (or on) 
knownas | Thisis called the binary system, and the rwo binary digits are called bits - so a bit is either 
Oorl 











Ec to expand the previous table of counting to include brary 

DECIMAL HEX BINARY 
0 0 0 
I 1 1 
2 2 10 
3 3 п 
4 4 100 
8 5 101 
6 6 110 
1 7 ш 
8 8 1000 
9 9 1001 
10 А 1010 
n B 1011 
12 c 1100 
13 р 1101 
l4 E по 
18 F nu 
16 10 10000 

п 10001 
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Ilis customary to pad ct binary numbers with leading zeros so thal they always contain at ieast four. 
bits~for example, 0000.000. 27 (representing 0 to 3decima!) 


Converting between binery zr: hex is very easy (use the previous table to help you) 





Тосопует а binary sus per to hex. split the biesry number mto groups of four bits(startingatthe night 
‘ofthe number) and consart each Group of Nur bits into tts corresponding hex digit. Finally purthe hex 
digits togettier to form rhe complete hex number For example, to convert 10110100 binary into hey. 
convert the first (nght-nand) group of four bits (0100) t 4 hex. then convert the next group of four bits 
(101))to B hex. put there ther зла you have the complete hex number - E4h ће binary number 
15 longer than eight bits. you antimue converting each group of four bits into ane hex digit. For 
example, | 11010111 10000 binary moreesponds to 3A FOR. 


To convert a hex number to binary, change eacn hex digit into four bits (again, starting at the right) 
then put the bits together to form the complete bmary number For example. to convert F3h to bmary 

first convert 3 which corresponds to 0011 binary (remember - you must use zeros to make the binary 
number four bits long), then convert F which corresponds to 1111 binary. put them together, and you 
have the complete bmary number - 11110011 


Although computers use a pure binary system, humans often write the numbers stored inside а 
computer using hex notation - after ай, the number 3AF 0h (for example) is far more likely to be easily 
and correctly read than 001110101 11 10000 in sixteen Eit binary notation. 


The bits inside the computer are mostly grouped into sets of eight - these are called bytes. A single 
byte can represent any number from 0 to 295 decimal (1 111111 bmary or РР). 


Two bytes can be grouped together to make what ts technically called a word. A word can be 
expressed using sixteen bits or four hex digits, and represents a number from 0 to 65535 decimal 
(UTD HIN binary or FFFFh) 


Abyteisalways eight bits. but words vary in length from computer to computer 


The BIN notation (used in part 14 of this chapter) provides a means of éntering numbers in binary оп 
the +3. е BIN 18 represents 4 decimal BIN 111 represents 7 decimal, 
BIN 11111111 represents 255 decimal. and soon 


You can only use 0s and Is ior this so the number must be a non-riedanve whole number - for instance. 
you can not use BIN -11 to represent -3 decimal. but you can use -BIN 11 instead The 
number must also be no greater than decimal 65535 -1e it сап! have more than sixteen bits if you рай 
ош à binary number with leading zeros. for example BIN 00000001 the BIN function will 
rightly amore them and treatthenumberasifitwereBIN 1 






















Part 33 
Example programs 


Programs... 


Renumber 
Clock 
Bustout 
Telly tennis 


Renumber 


This short program ts an aid to the renumbering facility provided by the edit menus Renumber 
option. If you MERGE this program into the program you are developing (or wish to renumber), you 
will be able to select both the starling line number and the step swe (between successive program 
lines) 


Type RUN 9888 to run the program, enter the start line (m the range |...9999), enter the step size 
(m the range 1.8999), then press the EDIT key and select the Renumber option from the edit 
menu 


9000 INPUT "Start Line",st 

9010 INPUT "Step size",sp 

9020 LET hst= INT (st/256) 

9030 LET hsp- INT (sp/256) 

9040 POKE 23413,st-256*hst 

9050 POKE 23414,hst 

9060 POKE 23415,sp-256*hsp 

9070 POKE 23416,hsp 

9080 PRINT "Press EDIT then sele 

ct Renumber option" 


Clock 


This programsersupthe +3 asananaloque (and chantal) clock 


Type RUN to start the program, e 
0...59). The clack wil! then start 





ter the hour (in the range 1 12) and enter the minute (in the range 


10 DIM s(60): DIM c(60) 

20 BORDER Ø: PAPER Ø: BRIGHT 1 
z INK 7: CLS 

30 PRINT AT 10,1;"Hold on whil 
e I calculate" 
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—) 


40 PRINT AT 11,2;"some sines а 
nd cosines” 

50 GO SUB 370 

60 LET z$="00" 

70 CLS 

80 INPUT "What hour is it ";h 

90 INPUT "How many minutes pas 
tim 

100 LET 5=0: POKE 23672,0: POKE 
23673,0 

110 IF h=12 THEN LET һ=0 

120 LET xc-112: LET ус=90: LET 
г=70: LET гһ=г/2: LET гт=гж 
3/4: LET rs=r*5/6 

130 CIRCLE xc,yc,r 

140 INK 1 

150 FOR 1=0 TO 359 STEP 30 

160 PLOT (г+1) ж5 (1/6+1) +хс,(г+1 
)* с(1/6+1) +ус 

170 NEXT i 

180 INK 4 

190 OVER 1: GO SUB 500 

?00 GO SUB 470 

210 GO SUB 440 

220 LET tm= INT (( PEEK 23672+2 
56* PEEK 23673)/50) 

230 IF s+1=tm THEN LET os=s: LE 
T s=s+1: GO TO 250 

240 GO TO 220 

250 IF s=6@ THEN LET 5=0: POKE 
23672,0: POKE 23673,0: LET 
om=m: LET m=m+1: GO TO 290 

260 PLOT xc,yc: DRAW rs*s(os*1) 
„г5*с(о5+1) 

270 GO SUB 440 

280 GO TO 220 

290 IF т=60 THEN LET m=@: LET o 
h=h: LET hzh*1: GO TO 330 

300 PLOT xc,yc: DRAM rm*s(om*1) 
,rm*c(Com*1) 

310 GO SUB 470 

320 GO TO 260 

338 IF h-12 THEN LET h=8 
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340 PLOT xc,yc: DRAW rh*s(oh*5* 
1),гһ*с(оһ*5+1) 

350 GO SUB 500 

360 GO TO 300 

370 PRINT AT 14,0 

380 FOR i=6 TO 360 STEP 6 

S90 PRINT "i"; 

400 LET 5(1/6)= SIN ((i-6)* PI 
/180) 

410 LET с(1/6) = COS ((i-60* PI 
/180) 

420 NEXT i 

430 RETURN 

440 PLOT xc,yc: DRAW rs*s(s*1), 
гѕжс(5+1) 

450 LET s$- STRS (s): PRINT OVE 
R' Ur AT 18,27; INK 4;"1'; I 
NK 6;2$( TO 2- LEN (s$));s$ 

460 RETURN 

470 PLOT xc,yc: DRAW rm*s(m*1), 
rm*c(m*1) 

480 LET m$- STR$ (т): PRINT OVE 
KR Uf AT T826: INK 22"s"5- Y 
NK 5;28( TO 2- LEN (m$));n$ 

490 RETURN 

500 PLOT xc,yc: DRAW rh*s(h*5+1 
),rh*c(h*5*1) 

510 LET ph=h: IF рһ=@ THEN LET 
phz12 

520 LET h$- STRS (ph): PRINT OV 
ER Ø; INK 3; AT 18,22;" "( 
TO 2- LEN (h$));hS 












530 RETURN 
Bustout 
This program provides a союш Шапа entertar ittie game for one player against fhe computer 
Toplay the game. type RUN then press апу key to start 
‘Options 
Cursor lt sthe bat left. 
Cursor right) е bat night. 
The spa: fe fora new screen 


Seeif you can aet the highest score” 
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Note the following when typing in the listing 


| The "BBBBBBB.."s shown in i 30 and 50 are graphics characters. They are 
produced by pressing the GRAPH key once (to switch graphics mode on), typing the 
characters (using the B key). then pressing the GRAPH key again (to switch graphics mode 
off) 








2 The "3333"sshown in line 2 Dare also graphics characters. Again. they are produced by 
pressma GRAPH once, pressing the 3 key four times, then pressing GRAPH асат (Note that 
these characters will look like black blocks on the screen.) 


3, The "А" shown in hne 4: also а graphics character, Again, it is produced by pressing 
GRAPH once, pressing the A key once. then pressing GRAPH again. 





10 BORDER Ø: INK 0: PAPER Ø: C 
LS : BRIGHT 1 

?0 GO SUB 560 

30 LET bS-"BBBBBBBBBBBBBBBBBBB 
BBBBBBBBB": REM 28 Bs 

40 LET s$=" 

": REM 32 spac 

es 

50 PRINT AT 3,12; INK 7; FLASH 
1;"BUSTOUT"; FLASH 8; AT 6 
29; INK 1;"B"; INK 7;" = 20 
Points"; AT 8,9; INK 4;"B" 
; ІМК 7;" = 10 Points"; AT 
38,9; : INK "В" INK T?" = 
5 Points" 

60 PRINT AT 14,1; INK 4;"Press 
SPACE or FIRE to trade"; A 
T 16,3;"a life for a new sh 
eet." 

70 PAUSE 200 

80 LET һіѕсоге=0 

90 LET tscore-ü 

100 LET lives 

110 LET ѕсоге=0 

120 CLS 

130 INK 7: PLOT 12,13: DRAW 0,1 
60: DRAW 230,0: DRAW 0,-160 

INK 

140 PRINT AT 1,2; INK 1;b$; AT 

2,2; INK 4;bS 











300 


150 
160 
170 


180 
190 


200 
210 


220 


230 
240 


250 
260 


270 


280 
290 
300 
310 


320 


330 
340 
350 
360 
370 





FOR r=5 TO 6: PRINT AT r,2; 
INK 2;b$: NEXT r 

LET bx=9 

PRINT AT 19,5; INK 6;"PRESS 
ANY KEY TO START"; AT 17,4 
¿"Use < and > to move bat" 
PAUSE 0 

PRINT AT 19,5; INK Q;s$( TO 
24); AT 20,0;s$C TO 32); A 
T 17,4;s$( TO 24) 

PRINT AT 21,0; INK O;s$( TO 
32): GO SUB 540: GO TO 220 
PRINT AT 20,bx; INK Q;" "; 
INK 52"3333^5 INK 82" "i RE 
TURN 

LET xaz1: LET yaz1: IF INT 
€ RND *2)-1 THEN LET ха=-ха 
GO SUB 210 

LET x=bx+4: LET y=11: СЕТ x 
c=x: LET ус=у 

REM main loop 

IF score>110@ THEN GO TO 11 
@ 





IF INKEYS =" " OR INKEYS =" 
Q" THEN IF lives»1 THEN LET 
Lives-lives-1: GO TO 110 

LET xc=x+xa: LET ус=у+уа 
REM scan the keyboard 

GO SUB 470 

IF ус=20 THEN IF ATTR (yc,x 
c)=69 THEN PLAY "Nig": LET 
уа=-уа: LET ус=ус-2: IF xc- 
bx+1 OR xc=bx+4 THEN LET xa 
=-ха: LET xc=x+xa 

IF ус=21 THEN PLAY “O3N7#d" 
: PRINT AT y,x;" ": GO TO 4 
50 

GO SUB 470 

IF yc=2@ THEN GO TO 430 
LET t= ATTR (yc,xc) 

IF t=71 THEN GO TO 410 

IF t=64 THEN GO TO 420 
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caasas 


380 LET уа=-уа: LET xz-xc: LET 
yz=yc: LET yc-yc*ya: GO SUB 
510: IF t-66 THEN PLAY "N1 
е": LET score=scoret5: LET 
tscore=tscore+5: GO SUB 540 

GO TO 358 

390 ІР t=68 THEN PLAY "Nic": LE 
T score-score*10: LET tscor 
e-tscore*10: GO SUB 540: GO 
TO 350 

400 IF t=65 THEN PLAY "Nia": LE 
T score-score*20: LET tscor 
e-tscore*20: GO SUB 540: GO 


TO 350 
410 LET ха=-ха: LET xc-xc*2*xa: 
PLAY "N1f" 


420 IF yc=1 THEN LET ya=1 

430 PRINT AT y,x; INK Q;" "; AT 
yc,xc; INK 3;"A": LET x-xc 
: LET у=ус 

440 GO TO 250 

450 LET Liveszlives-1: IF lives 
=Ø THEN GO TO 530 

460 GO SUB 540: GO TO 220 

470 LET a$-INKEYS 

480 IF (а$= CHRS (8) OR a$-"6") 
AND bx>1 THEN LET bxzbx-1: 
GO SUB 210: RETURN 

490 IF (a$- CHR$ (9) OR а$="7") 
AND bx«25 THEN LET bx=bx+1 
: GO SUB 210: RETURN 

500 RETURN 

510 IF yz-20 THEN RETURN 

520 PRINT AT yz,xz; INK 0;" ": 
RETURN 

530 GO SUB 540: PRINT AT 10,10; 
INK 7;"GAME OVER"; AT 12,8 
¿"You scored : ";tscore: FO 
R i=1 TO 300: NEXT i: GO TO 
90 

540 IF tscore>hiscore THEN LET 
hiscore=tscore 
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550 


560 
570 
580 
590 
600 
610 
620 


630 
640 
650 
660 
670 
680 
690 
700 
710 


PRINT AT 21,11; INK 6;"HISC 
ORE ";hiscore; AT 21,1;"SCO 
RE ";tscore; AT 21,24;"LIVE 
S ";lives: RETURN 

FOR i= USR "a" TO USR "Ь"+7 
READ b 

POKE i,b 

NEXT i 

RETURN 

REM ball 

DATA 0,60,126,126,126,126,6 
0,0 

REM brick 

DATA BIN 11111111 

DATA BIN 10000001 

DATA BIN 10111101 

DATA BIN 10111101 

DATA BIN 10111101 

DATA BIN 10111101 

DATA BIN 10000001 

DATA BIN 11111111 


Telly tennis 


Thi 
Fur 





Type RUN tos 


Options 






rs) lo play 





pomputer qi 








303 





3 The " 
GRAPH onc, pressina ti 


10 


100 


110 
120 
130 
140 
150 
160 
170 
180 
190 


200 
210 
220 
230 









shown In 


PAPER 4: INK 0: BRIGHT 0: В 
ORDER 4 

CLS 

GO SUB 730 

DIM x(2): DIM y(2): DIM p(2 
) 

LET comp=1: LET 5с1=0: LET 

Sc2-0: LET z$-"Q" 

PRINT AT 2,9; INK 7;"TELLY 

TENNIS" 

PRINT AT 8,3;"ONE OR TWO PL 
AYERS (1/2)2" 

LET iS-INKEYS 

IF i$-"1" THEN PRINT AT 12, 
8;"Use A to go up"; AT 14,8 
¿"and Z to go down": GO TO 

120 

IF i$ ="2" THEN PRINT AT 10 
,3;"Player 1 use A to go up 
"; AT 12,12;"and Z to go do 
wn"; AT 14,3;"Player 2 use 

K to go up"; AT 16,12;"and 

M to go down": LET сотр=0: 

GO TO 120 


GO TO 80 
FOR 1=0 TO 200: NEXT i 
LET х(1)=2: LET y(1)=3 





LET x(2 LET y(2)=18 

LET е$=" : LET f$="66" 

PRINT AT 1,0; 

GO SUB 400: REM top edge 

FOR i=3 TO 19 

PRINT AT i,0; INK 6;f$; INK 
0; TAB 30; INK 6;fS 

NEXT i 

PRINT AT 20,0; 

GO SUB 400: REM bottom edge 

PRINT AT 0,0; INK 1;"Player 
1: 00"; AT 0,19; INK 2;"PL 

ayer 2 : 00" 





пастет; Again, it is produced by pressing 
essing GRAPH сат 


240 LET n= INT ( RND *2) 

250 FOR 1=1 TO 2: PRINT AT y(i) 
snti); INK 1;"8"; AT ycia 
,xXC69;"B": NEXT i 

260 IF п=0 THEN LET xbz21: LET 
dx=1: GO TO 280 

270 LET xb=19: LET dx=-1 

280 LET yb=12: LET dy= INT ( RN 
D *3)-1 

290 GO SUB 440: REM move bats 

300 LET oxb-xb: LET oyb=yb: LET 
scd-Ü 

310 GO SUB 580: REM move ball 

320 PRINT AT oyb,oxb; INK 0;" " 

330 PRINT AT yb,xb; INK 7;"A" 

340 IF scd=@ THEN GO TO 290 

350 PRINT AT yb,xb; INK @;" " 

360 GO SUB 380 

370 GO TO 240 

380 PRINT AT 0,10; INK 1;2$( TO 
2- LEN ( STR$ (sc1)));sct; 
AT 0,30; INK 2;2$( TO 2- L 
EN ( STR$ (sc2)));sc?2 

390 RETURN 

400 FOR i=1 TO 64 

410 PRINT INK 5;e$; 

420 NEXT i 

430 RETURN 

440 LET aS=INKEYS 

450 IF а$="а" THEN LET p(1)--1 

460 IF a$-"z" THEN LET p(1 

470 IF comp=1 THEN LET p(2)=(2* 
Cy (2)<Cyb))-Cy(2)>(yb))): G 

o 


















480 " THEN LET p(2)= 
498 т" THEN LET p(2)=2 
500 TO 2 


510 LET a= ATTR (yG2O*pCGO,x(G) 
) 

520 IF р(і)=2 THEN LET р(1)=1 

530 If a-32 THEN PRINT INK O; A 
т PORTERS" сат y65044,. 
кої)" ": LET y CO sy GO*pCG 
) 





308 


SS 


540 PRINT АТ y(i),x (i); INK i; 
*B"; AT УСУ x07) 5"8? 

550 LET р(ї)=0 

560 NEXT i 

570 RETURN 

580 LET w= ATTR (yb*dy,xb*dx2 

590 IF w-32 THEN LET xbzxb*dx: 
LET yb=yb+dy: RETURN 

600 IF w=33 OR w=34 THEN LET dx 
7-dx: PLAY "V1507N1g": LET 
dy= INT ( RND *3)-1: RETURN 

610 IF w=38 THEN GO TO 64Q 

620 IF w=37 THEN PLAY "V1507N1c 
"i LET dy=-dy 

630 RETURN 

640 PLAY "O3V15#d": IF dx>@ THE 
N LET $с1=5с1+1: GO TO 660 

650 LET sc2=sc2+1 

660 LET Чд=(5с1=15)+2*(5с2=15): 
LET scd=1 

670 IF d <> THEN GO SUB 380: 
PRINT INK 7; AT 10,8;"Playe 
p "sd" w$hs."S AT 12,7;"PL 
ay again (y/n)?": 60 TO 690 

680 RETURN 

690 IF INKEYS ="" THEN GO TO 69 
0 

700 IF INKEYS ="y" THEN RUN 

710 IF INKEYS -"n" THEN STOP 

720 GO TO 690 

730 FOR і=0 TO 7 

740 READ n 

750 POKE USR "a"*i,n 

760 NEXT i 

770 RETURN 

780 DATA 0,60,126,126,126,126,6 
0,0 





Chapter 9 
Using the calculator 





Subjects covered... 


Selecting the calculator 

Entering numbers 

Running total 

Using built-in mathematical functions 
Editing the screen 

Assigning variables 

User defined functions 

Exit-ing from the calculator 


tthe Calculator opt If you don't 





on 
edit 
есі ће Calculator 
ted the calculator) 






uhave selected the Calculator opt 





e +3 culatot Steady tp accept your бте иту. Type 
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6*4 


As soon as you press ENTER, the answer 10 wil! appear. (Note that you don't key tn = as you would 
onaconventional calculator ) 


You will see that the cursor is posinoned 10 night of the answer. which 1s a running total (hke on a 
conventional calculator). This means that you can simply type in the next operation to be camed out 
‘on the munning total (without having to type in а whole new calculation) So, with the cursor stili 
positioned to the right of the 10 onthe screen, type in 


15 


„and back comes the answer 2. Now type m. 


*PI 


‘This produces the result 6 «2831853 onthe screen. The 3: has used its builtin z function - al 
you had t6 do was type m P I, This apples to all the + s mathematical functions To demonstrate 


type in, 
*ATN 60 


which gives the result 9,7648943 You may also ear the 
demonstrate, move the cursor [ing the cursor left кеу ўро the Бесит 
INT sothat the line reads. 


INT 9.7648943 


mts of the screen Tc 
of the ипе anid then type m 






ver 9 This also demonstrates that the 
аше of an expression As another 





and as soon as ENTER ts pres 
+3 doesn't have to perform a 
example, press ENTER then type 


1E6 


es the an 
Папол in order to print the 








гапа back will come the value of that expression Notice that before you typed и: 1Е6 you pressed 
ENTER onitsown-thistelisthe +3 that you are about to start a new calculation 





One extremely useful feature af the +3 s calculator 1s that и wil! allow you te ass ies to 
variables and ther use them m subsequent calculsnons This ts achiev ing the LET statemant 
(as you would in BASIC) То demotisttare press ENTER ana type in the “10у 


LET х=10 























"Tod stt ENTER twice forthe +3 pasas Was verto fà 
n m н 

x*90 

+х*х 

1 r j 

EDIT 
= 
Exi topt d 3 

*3 BASIC the Calculator 


+3 


9000 DEF FN c(n)=n*n*n 


FN c(3) 
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Chapter 10 
Peripherals for your +3 





Subjects covered... 


Cassette unit 

Printer 

Additional disk drive 
Joystick(s) 

VDU Monitor 
Amplifier 

Serial devices 

MIDI device 
Auxiliary interface 
Expansion devices 






The +3 is ci 


printer, cas 


(peripherals) such as joystick(s), 
essary to connect these 


Cassette unit 


Programs may be loaded fr 
»ompuleér to direct data t 


| 


ds which instruct the 
mual) 










1 your cassette unit to the +3. you will require a suitable interconnecting lead, wired as 






TAPE/SOUND sockelonihe +3 Cassette umt 


Input (EAR 


Input (EAR) | 
Output(MIC) —^ \ | 
ӨМ (common) 


Output 
(MIC) 





To EARsocket 









To MICs 








зп 





You will see that the shaft of one of the jack plugs is divided into З separate metal sections -this is е 
plug that should be inserted into the socket marked TAPE/SOUND at the back ofthe +3. 


The shafts of the other two jack plugs are divided mto only 2 separate metal sections - these are the 
plugs that should be mserted into the sockets ол your cassette unit marked MIC and EAR. (On most 
commercially available leads the plua for the MIC socket is coloured red ) 


(On some cassette units, the MIC socket may be labelled COMPUTER IN or INPUT Likewise, the 
EAR socket may be labelled COMPUTER OUT or OUTPUT.) 


Ir ts important to remember that the successful transfer of programs 10 and from tape 1s largely 
dependenton the correct setting of the LEVEL or VOLUME control on your cassette umt Ifyou cannot 
load от save programs easily t menting with different LEVEL control positions ший the 
optimum setting ts found If you cannot seem to load or save any programs at all. try reversing the 
plugs te the MIC and EAR sockets on your cassette unit 















Detarisol tape'operation Ул! be found in chapter 4 and chapter В parts 20 and 27 


Printer 


The +3 may be used with ony Centronics compatible parallel printer We would particularly 
recommend the AMSTRAD DMP range of proners (er. models DMP2000 DMP3000. DMP3160 от 
DMP4000) for use with the +3. 











Y yon intend ty 
provided with the prin 


t the AMSTRAD) DMP2000 to the +3 simply use the interconnecting lead. 
ler 





Ifyou mishto use апу other Centron 
interconnecting lead. 


compatible prmter you wil require the AMSOFT PL: i printer 





Connect the en 
PRINTER : the 


Connect the uther end of the lead (which is fitted vath а Centronics styie plug) into the socketon the 
рите If your printer is е 7 
into the cut-outsat the side of the pnnter ph 





ofthe lead which ts fitted with the flat eage 
puck ofthe +3 


imector plug. into the socket marked 
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+3 s PRINTER socket the y те num 


Vote that pr ise with the +3 








serial printer È тес the RS232/MIDI у ithe +3 





Additional disk drive 


The AMSTRAD model FD- | may be added tothe +3 system азап additional disk drive. 


Thanks to the versatility of +3 BASIC. you can do all necessary file maintenance, copymg, erasing 
ètc., on à single disk drive However. a second drive will certamly speed up these processes and 
reduce the scope for accidents 


Toconnectthe FD-] tothe +3. you will require the AMSOFT DL-2 disk interconnecting lead. 


Connect the end of the lead which is fitted with the larger edae-connector plug, into the socket 
marked DISK В: at the backofthe +3 


Connect the other end of the lead which is fitted witha smaller plug, mto the socket at the back of the 
FD-1 disk drive 


Important- Before connecting or disconnecting the additional disk drive. make sure һа! апу disks are 
removed from both drives. ani i 'chions are altered while tha 
system 1s on. и ts likely that the system will crash iosmg any program ot data. Always save any 
valuable programs before meddling with connections! 


When the P'D-| is connected to the +3 first ch on the FD-1 (using the slide switch at the back of 
the disk drive), thenswitchon the +3 (by plugama in the PSU). Both the areen and red indicatorsan 


the front panel of the FD-1 should be illuminated. The two-dnive system will then be ready to operate 













2 4 6 в © 12 4 16 18 20 22 24 26 28 3 32 34 


13 5 79 т 1з 5 v 19 21 23 25 27 29 з 33 


(viewed from rear i 


DISK B: cce! 
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r ththe +3. Othertypes of joystick 
n t red differentiy 

i neral gamesuse the JOYSTICK 1 
ype :hoase th wo (ot Sinclar) option. 





lethe +3 isswitchedon 
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JOYSTICK 1 and JOYSTICK 2 


VDU Monitor 





U n the RGB/PERITEL 





RGB/PERITEL 
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When using а monitor, some provision may have to be made for sound (if required) If the monitor has. 
anaudio input, then then this should be connected either to pm 3 of the RGB/PERITEL socket or to ће 
TAPE/SOUND socket af the back ofthe +3 If the monitor isnot capable of producing sound, then an 
external amplifier will have to be used See the next paragraph for further details. 


Amplifier 


The +3 normally Teproduces sound through the TV sett is connected to. However, ifa VDU monitor 
is is being used. or if you would like to record or amplify the sound further, then à sound signal 1s 

watlable from the TAPE/SOUND socket at the back of the +3 This is a 38mm jack socket 
OD inq 200mV pk-pk at approximately 3 Kohms impedance When using an amplifier, it i$ worth 
remembenng that i! you have connected a cassette umt to the +3 the tape Toad and ‘save’ signals 
ате also. fed to the TAPEISQUMO socket (and therefore the amplifiers volume control should be 
fumed ác hese operations) 












wte 18 that the ievel of sound produced by the BE EP command 1з set to be the same 
SPLAYr at the same time In practice, this means that BE EP will. 
ser than P LA Y (which may cause problems if sound levels are entical) 


t umplu «m ampatier, tape recorder, etc into ће TAPE/SOUND socket while 












(notused) 


иэш! —J [^ 
e 


Audiooutpur 


NB (eomm 


Audio output GND (common; 


TAPE/SOUND socket 





otthe 43'ssoundtaciities will pe found m chapter & part 18 
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Serial devices 


RS232 





Details of serial operations will be found pter Snati 


MIDI device 






Although the +3's MIDI(M ке! as the 

R5232, you wi i е lead should be 
mected mto the "Mi V sock provision for 

the +8 10 receive MIDI data - 1 necessary 

Before use (exceptibe inclumon of ti 

Using the MIDI interi td 





MIDI socket 





Details of MIDI operati 











Auxiliary interface 


The AUX (auxiliar 
2 and 4) The VO In 
the YO lin 
ofthe AY 








AUX pin 30r 
AUX pin 50 
RS232; 
RS232: 








Using softwate c 
the RS232/MIDI х 


drive, for exemple 


ort (m the same way às. 
ines could be used to 





AUX socket 
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Expansion devices 


The +3 canco lo a very wk 
of the machme. Although this soc! 
guarantee that a device whi 
therefore, before you pur: 
and not just with a 48K Sj 











ich 








WARNING - It i$ very 
EXPANSION 1/0 s 


the +3 ала the expan 





AIS 
Al3 
DI 
ROMIOE 
Do 

DI 

ne 
D6 






> 








iom oc) oto 
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UPPER ROW (U) LOWER КОМ (L) 











Detailsofthe +3'shardware will be found in char 
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Additional disk drive 17,314 
Aeriallead 5 
14,15 

„ 194,317 

AMSTRAD computers 209, 213, 217 
AMSTRAD peripherals 312,314 
AND , 99, 278 
Animation m 161 
Apostrophe . 58,291 
Archive status „ 158 
Argument ..... 80, 265 


Arithmetic operations .. 86, 276, 281 
„~ 95, 153, 186, 265, 276 


=. 91,265,278 


„ 198, 258 
AT „ 110, 123, 175, 265,291 
АТМ. _ 91,218 
ATTR 120, 122, 278 
Attributes 151, 157.212 


Auxiliary interface 
AUX socket 


B 
Back-ups ... 
Backspace 
BASIC .. 
Baud rate 
BEEP .. 
BIN. 
Binary 
Bits 
Bootstray 
BORDER . 
Brackets 
BREAK key .. 
BRIGHT. 

Brightness 

Bytes ..... 











‚111 





с 
Calculator ....... 
CAPS LOCK key .. 
CAPS SHIFT key 
Cassette operation 
CAT 
Centronics 
Channels 
Characters 
CHRS ... 
CIRCLE. 
Circles 
CLEAR 
CLOSE 
CLS 

С mode 
CODE . 
Colon 
Colour .. 
Comma .. 
Commands 
Compatibility 
Connections 
Contents... 
CONTINUE 
Contrast 












36,44, 80, 103, 133 
21, 162,311 
~ 39, 148, 167, 268, 283 























102, 184, 161, 


106, 115, 122, 172, 288 
111,124 
158, 173, 268, 284 


Control codes characters . 









158, 166 
90,278 
46,213,219 
.. 18,32, 33, 48, 52 























DIM 


DISK В: socket . 314 


170, 179, 273, 319 
212 


Disks .... |, 18, 19, 36, 144, 213, 220 
Disk drive(s) 19, 25, 143, 160, 275, 314 
Disk format . 36, 40. 144,213 


AS 




































IF 
E IN 
EDIT key .. INK 
Editing INKEYS 
Edit menu INPUT 
Ejectinga Inserting disks ... 
E mode .... Installation 
ENTER key , 33, 48, Instructions 
Epson INT ca 
ERASE Interface Two 
Erasing files INV VIDEO key 28; 
Error messages INVERSE .. 120, 127, 174, 267, 284, 287,29] 
Escape code 10 „ 119,189 
ЕХР.. 
EXPANSION VO socket .. J 
Exponents .... 
EXTEND MODE key Joysticks .. „ 180,315 
External disk drive ... JOYSTICK sockets . 318 
K 
F Keyboard 48,49,52, 180 
Fields .. 










Filenames 
FLASH 
FN 


„ 119, 122, 267, 286, 291 
83, 267, 279,309 










FOR 65, 264, 286 
FORMAT 38, 144, 160. 171, 267. 285, 286 
Functions . 80.277.308 
G „ 114. 153, 167,171, 267, 286, 292 
G mode . 107,313 









G0 SUB |, 265, 32,34,54 
GO TO 57.58. 59, 265. 266 52.56, 265, 287 
GRAPH key masna 47, 51,103 33, 52. 288 









Graphics . 41.51.103. 124 172, 265, 288 
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119, 267, 290, A 





‚265, a 
. 105, 183,285, 219 


LPRINT. 


M 


Machine code 
Mains plug , 
Maintenance. 
Mathematical operations 
Memory 
Menus 
MERGE 
MIDS 
MIDI 

MIDI socket 
Monitor 
MOVE 
Music .. 











‚58, 
151, 168, 110, 180, 312 
170,176,312 


„ 59,16,82 


179,290 = 
120, 127, 267,290, 29) : 14, 16,20,24 
.. 119, 121, 127 20,24 








325 


—_ aaaaaaaaaaaaaaaaaaaaaaaaasasassasaiħiIiIițIA 


RESTORE 
RETURN 
RGB/PERITEL socket 
RIGHTS .. " 
































RND 

ROM 179, H 222, 273 
Rounding numbers | 82,84 
RS232 ... 170, 180,318 
RS232 socket 71, 176, 213. 313, 318. 
RUN „ 39,55,58, 59, 265, 292 
S 

Safety _ 8,10, 18 
SAVE 38, 146, 153, 162, 266, 292 
Savinga program... 38, 153, 162, 199 
Screen display 33,35, 48, 52, 124. 154. 173 
SCREENS ... 110, 155, 160, 166, 280, 285, 288, 292 
Scrolling 52, 58,67, 115 
Semicolon 58,291 
Serial interface 171. 180, 318 
Servicing ma T 
Setting up 

SGN. 

Sign 

SIN 

Sine wave 

Slicing 

Software = 

Sound 134,273,317 
Source - 158 
Speakers 

SPECTR 44, 160, 189.208, 285, 292 
Spectrum 48 22, 43, 208 
SAR.. „ 83. 124. 265, 280 
Squareroot " 
Stack . 

STEP 

STOP 

Stopping a program. 59. 
STRS 81,280 
Streams 

String expressions 

Subroutines 

Subscript 

Substring 


Switching on off 







System status files 































System vanables 

T 

TAB 

TAN 

‘Tape operation 21. 162, au 
TAPE/SOUND socket . 21, 134,311,317 
Test signal „ 13,15,16 
ТНЕМ - ‚ 62,99, 286 
Timing 130,273 
TLS .. 85 
TO 65, 71, 38, 156, 268, 277, 284. 289 
Tokens .. 44, 102, 106, 111, 172 
Transparent `.. _ . ls 





86 
15 
287 
n 13,15 
10. 13, 120,316 


Trigonometrical functions 














ULA .. 
Unpacking 
User area number 
User defined function 
User defined graphics 
USR ... 


у 


УА... 
VALS 

Vanables 
VDU .. 
VERIFY 
Volume .. 








35, 74, 181, 185, 265, 276. 308 

" ~ 134,316 
185. 266,292 
13,15,312 





Warnings 
Wildcards 
Write protection 






26,40, 157 


























X-axis ... .90 
X-coordinate 111, 124 
T 

Y-axis ... .90 
Y-coordinate 111,124 
Z 

780 micro processor ‚ 189, 198, 258, 273 
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